concevent-ai-agent-sdk 1.0.0

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export { createWebSocketHandler, parseClientMessage, serializeServerMessage } from './websocket.js';
+export type { ClientMessage, ServerMessage, WebSocketHandler } from './websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACpG,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,2 @@
+export { createWebSocketHandler, parseClientMessage, serializeServerMessage } from './websocket.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/adapters/websocket.d.ts

@@ -0,0 +1,23 @@
+import type { Agent, AgentEvent, AgentResult, ToolExecutorContext } from '../index.js';
+export type ClientMessage = {
+    type: 'chat';
+    message: string;
+    context: ToolExecutorContext;
+} | {
+    type: 'abort';
+} | {
+    type: 'clear_history';
+} | {
+    type: 'get_history';
+};
+export type ServerMessage = AgentEvent;
+export interface WebSocketHandler {
+    handleMessage(message: ClientMessage, sendEvent: (event: ServerMessage) => void): Promise<void>;
+    handleChat(message: string, context: ToolExecutorContext, sendEvent: (event: ServerMessage) => void): Promise<AgentResult>;
+    handleAbort(): void;
+    handleClearHistory(): void;
+}
+export declare function createWebSocketHandler(agent: Agent): WebSocketHandler;
+export declare function parseClientMessage(data: string): ClientMessage | null;
+export declare function serializeServerMessage(event: ServerMessage): string;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/adapters/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/adapters/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EAEL,UAAU,EACV,WAAW,EACX,mBAAmB,EAKpB,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,UAAU,CACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GACxC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,WAAW,IAAI,IAAI,CAAC;IACpB,kBAAkB,IAAI,IAAI,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAmGrE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAerE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAKnE"}

package/dist/adapters/websocket.js

@@ -0,0 +1,95 @@
+import { createEvent } from '../types/events.js';
+export function createWebSocketHandler(agent) {
+    function createCallbacks(sendEvent) {
+        return {
+            onThinking: (thinking, details) => {
+                sendEvent(createEvent('thinking', { thinking, details }));
+            },
+            onMessage: (message, reasoning) => {
+                sendEvent(createEvent('message', { message, reasoning }));
+            },
+            onToolCallStart: (calls) => {
+                sendEvent(createEvent('tool_call_start', { calls }));
+            },
+            onToolResult: (result) => {
+                sendEvent(createEvent('tool_result', { result }));
+            },
+            onUsageUpdate: (usage) => {
+                sendEvent(createEvent('usage_update', { usage }));
+            },
+            onSummarizationStart: (originalMessageCount) => {
+                sendEvent(createEvent('summarization_start', { originalMessageCount }));
+            },
+            onSummarizationEnd: (summary, tokensEstimate) => {
+                sendEvent(createEvent('summarization_end', { summary, tokensEstimate }));
+            },
+            onIterationStart: (iteration, maxIterations) => {
+                sendEvent(createEvent('iteration_start', { iteration, maxIterations }));
+            },
+            onError: (error) => {
+                sendEvent(createEvent('error', error));
+            },
+            onComplete: (result) => {
+                sendEvent(createEvent('complete', { result }));
+            },
+            onAborted: () => {
+                sendEvent(createEvent('aborted', {}));
+            },
+        };
+    }
+    async function handleChat(message, context, sendEvent) {
+        const callbacks = createCallbacks(sendEvent);
+        return agent.chat(message, context, callbacks);
+    }
+    function handleAbort() {
+        agent.abort();
+    }
+    function handleClearHistory() {
+        agent.clearHistory();
+    }
+    async function handleMessage(message, sendEvent) {
+        switch (message.type) {
+            case 'chat':
+                await handleChat(message.message, message.context, sendEvent);
+                break;
+            case 'abort':
+                handleAbort();
+                break;
+            case 'clear_history':
+                handleClearHistory();
+                break;
+            case 'get_history':
+                break;
+            default:
+                console.warn('[WebSocketHandler] Unknown message type:', message.type);
+        }
+    }
+    return {
+        handleMessage,
+        handleChat,
+        handleAbort,
+        handleClearHistory,
+    };
+}
+export function parseClientMessage(data) {
+    try {
+        const parsed = JSON.parse(data);
+        if (parsed.type === 'chat' ||
+            parsed.type === 'abort' ||
+            parsed.type === 'clear_history' ||
+            parsed.type === 'get_history') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function serializeServerMessage(event) {
+    return JSON.stringify({
+        ...event,
+        timestamp: event.timestamp.toISOString(),
+    });
+}
+//# sourceMappingURL=websocket.js.map

package/dist/adapters/websocket.js.map

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

package/dist/core/agent.d.ts

@@ -0,0 +1,11 @@
+import type { AgentConfig, AgentCallbacks, AgentResult, ChatMessage, ToolExecutorContext, UsageMetadata } from '../types/index.js';
+export interface Agent {
+    chat(message: string, context: ToolExecutorContext, callbacks?: AgentCallbacks): Promise<AgentResult>;
+    abort(): void;
+    getHistory(): ChatMessage[];
+    setHistory(history: ChatMessage[]): void;
+    clearHistory(): void;
+    getTokenUsage(): UsageMetadata;
+}
+export declare function createAgent(config: AgentConfig): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/core/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,aAAa,EAEd,MAAM,mBAAmB,CAAC;AA+B3B,MAAM,WAAW,KAAK;IACpB,IAAI,CACF,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,UAAU,IAAI,WAAW,EAAE,CAAC;IAC5B,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACzC,YAAY,IAAI,IAAI,CAAC;IACrB,aAAa,IAAI,aAAa,CAAC;CAChC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAuatD"}

package/dist/core/agent.js

@@ -0,0 +1,296 @@
+import { createOpenRouterClient } from './openrouter-client.js';
+import { convertChatMessagesToOpenAI, convertFunctionDeclarationsToTools, convertOpenAIToolCallsToFunctionCalls, mapOpenAIUsageToMetadata, normalizeReasoning, createSystemMessage, createUserMessage, createAssistantMessage, } from './openrouter-utils.js';
+import { ToolExecutor } from './tool-executor.js';
+import { summarizeConversation, createSummaryMessage, shouldSummarize, DEFAULT_CONTEXT_LIMIT_TOKENS, } from './summarization.js';
+import { AgentSession } from './session.js';
+import { AgentError, formatErrorTrace, isAbortError, createErrorMessageResolver, } from './errors.js';
+import { logger } from './logger.js';
+const DEFAULT_MAX_ITERATIONS = 20;
+const MAX_RETRY_ATTEMPTS = 2;
+export function createAgent(config) {
+    if (!config.apiKey) {
+        throw new AgentError('API_KEY_REQUIRED');
+    }
+    if (!config.model) {
+        throw new AgentError('MODEL_REQUIRED');
+    }
+    const client = createOpenRouterClient({
+        apiKey: config.apiKey,
+        baseURL: config.baseURL,
+    });
+    const toolExecutor = new ToolExecutor(config.tools);
+    const session = new AgentSession();
+    const resolveErrorMessage = createErrorMessageResolver(config.errorMessages);
+    const maxIterations = config.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+    const temperature = config.temperature ?? 0.1;
+    const reasoningEffort = config.reasoningEffort ?? 'high';
+    const contextLimitTokens = config.summarization?.contextLimitTokens ?? DEFAULT_CONTEXT_LIMIT_TOKENS;
+    const summarizationEnabled = config.summarization?.enabled ?? true;
+    async function performChatCompletion(messages, tools, abortSignal) {
+        if (abortSignal?.aborted) {
+            throw new AgentError('REQUEST_ABORTED');
+        }
+        const response = await client.chat.completions.create({
+            model: config.model,
+            messages,
+            tools: tools.length > 0 ? tools : undefined,
+            temperature,
+            reasoning_effort: reasoningEffort,
+        });
+        return response;
+    }
+    async function executeChatCompletion(messages, tools, abortSignal, allowEmptyRetry = true) {
+        const response = await performChatCompletion(messages, tools, abortSignal);
+        if (!response) {
+            throw new AgentError('NO_RESPONSE');
+        }
+        const responseMessage = response.choices[0]?.message;
+        if (!responseMessage) {
+            throw new AgentError('NO_RESPONSE_MESSAGE');
+        }
+        const responseText = responseMessage.content || '';
+        const toolCalls = responseMessage.tool_calls || [];
+        const usage = response.usage;
+        const { displayText: thinking, rawReasoningDetails: thinkingDetails } = normalizeReasoning(responseMessage.reasoning, responseMessage.reasoning_details);
+        if (!responseText && toolCalls.length === 0) {
+            if (!allowEmptyRetry) {
+                throw new AgentError('EMPTY_RESPONSE');
+            }
+            console.info('[Agent] Empty response with no tool calls detected, retrying once...');
+            const retryMessages = [
+                ...messages,
+                createAssistantMessage(''),
+                createUserMessage('The previous response was empty, please send the requested answer'),
+            ];
+            return executeChatCompletion(retryMessages, tools, abortSignal, false);
+        }
+        return {
+            message: responseText,
+            toolCalls,
+            thinking,
+            thinkingDetails,
+            usage,
+            requestId: response.id,
+        };
+    }
+    async function attemptProcessMessage(userMessage, conversationHistory, context, callbacks, retryErrorTrace) {
+        const tools = convertFunctionDeclarationsToTools(toolExecutor.getToolDeclarations());
+        const systemMessages = config.systemPrompts.map((content) => createSystemMessage(content));
+        let currentHistory = [...conversationHistory];
+        let currentMessage = userMessage;
+        let iteration = 0;
+        let latestUsage = {};
+        let latestRequestId;
+        let summarized = false;
+        const userChatMessage = {
+            role: 'user',
+            content: userMessage,
+            timestamp: new Date(),
+        };
+        currentHistory.push(userChatMessage);
+        while (iteration < maxIterations) {
+            if (context.abortSignal?.aborted) {
+                callbacks.onAborted?.();
+                throw new AgentError('REQUEST_ABORTED');
+            }
+            callbacks.onIterationStart?.(iteration + 1, maxIterations);
+            logger.iteration(iteration + 1, maxIterations);
+            const messages = [
+                ...systemMessages,
+                createAssistantMessage('I understand the current context. I am ready to help you with your requests.'),
+                ...convertChatMessagesToOpenAI(currentHistory.slice(0, -1)),
+                createUserMessage(currentMessage),
+            ];
+            if (retryErrorTrace && iteration === 0) {
+                messages.push(createSystemMessage(retryErrorTrace));
+            }
+            logger.apiRequest(config.model, messages.length, tools.length > 0);
+            const { message: responseText, toolCalls, thinking, thinkingDetails, usage, requestId, } = await executeChatCompletion(messages, tools, context.abortSignal, true);
+            logger.apiResponse(!!responseText, toolCalls.length, !!thinking);
+            latestRequestId = requestId;
+            if (usage) {
+                latestUsage = mapOpenAIUsageToMetadata(usage);
+                logger.tokenUsage(latestUsage);
+                callbacks.onUsageUpdate?.(latestUsage);
+                session.updateTokenUsage(latestUsage);
+                if (summarizationEnabled &&
+                    latestUsage.totalTokenCount &&
+                    shouldSummarize(latestUsage.totalTokenCount, contextLimitTokens)) {
+                    callbacks.onSummarizationStart?.(currentHistory.length);
+                    logger.summarizationStart(currentHistory.length);
+                    const summaryResult = await summarizeConversation(currentHistory, client, config.model, config.summarization || { enabled: true }, reasoningEffort, temperature, context.abortSignal);
+                    if (!summaryResult.error && summaryResult.summary) {
+                        currentHistory = [createSummaryMessage(summaryResult.summary)];
+                        summarized = true;
+                        logger.summarizationEnd(summaryResult.tokensEstimate);
+                        callbacks.onSummarizationEnd?.(summaryResult.summary, summaryResult.tokensEstimate);
+                    }
+                }
+            }
+            logger.thinking(!!thinking);
+            if (thinking) {
+                callbacks.onThinking?.(thinking, thinkingDetails);
+            }
+            if (toolCalls.length > 0) {
+                const functionCalls = convertOpenAIToolCallsToFunctionCalls(toolCalls);
+                logger.toolCallStart(functionCalls);
+                callbacks.onToolCallStart?.(functionCalls.map((fc) => ({ id: fc.id, name: fc.name, args: fc.args })));
+                const executedCalls = await toolExecutor.executeToolCalls(functionCalls, context, (result) => callbacks.onToolResult?.(result));
+                const toolCallMessage = {
+                    role: 'tool-call',
+                    content: responseText || `Executing functions: ${functionCalls.map((fc) => fc.name).join(', ')}`,
+                    timestamp: new Date(),
+                    toolCalls: functionCalls,
+                    reasoning: thinking,
+                    reasoning_details: thinkingDetails,
+                    reasoningTokenCount: latestUsage.reasoningTokenCount,
+                };
+                currentHistory.push(toolCallMessage);
+                for (const executedCall of executedCalls) {
+                    const { content } = toolExecutor.formatToolResultForHistory(executedCall.id, executedCall.functionName, executedCall.result);
+                    const resultMessage = {
+                        role: 'tool-call-results',
+                        content,
+                        timestamp: new Date(),
+                        toolCallId: executedCall.id,
+                    };
+                    currentHistory.push(resultMessage);
+                }
+                currentMessage = 'Please continue with the complete answer.';
+                iteration++;
+                continue;
+            }
+            if (responseText) {
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: responseText,
+                    timestamp: new Date(),
+                    reasoning: thinking,
+                    reasoning_details: thinkingDetails,
+                    reasoningTokenCount: latestUsage.reasoningTokenCount,
+                };
+                currentHistory.push(assistantMessage);
+                const result = {
+                    message: responseText,
+                    reasoning: thinking
+                        ? {
+                            text: thinking,
+                            details: thinkingDetails,
+                            tokenCount: latestUsage.reasoningTokenCount,
+                        }
+                        : undefined,
+                    conversationHistory: currentHistory,
+                    usageMetadata: latestUsage,
+                    requestId: latestRequestId,
+                    iterations: iteration + 1,
+                    summarized,
+                };
+                callbacks.onMessage?.(responseText, result.reasoning);
+                logger.chatComplete(iteration + 1, summarized);
+                callbacks.onComplete?.(result);
+                session.setHistory(currentHistory);
+                return result;
+            }
+            break;
+        }
+        if (iteration >= maxIterations) {
+            const maxIterMessage = resolveErrorMessage('MAX_ITERATIONS');
+            const assistantMessage = {
+                role: 'assistant',
+                content: maxIterMessage,
+                timestamp: new Date(),
+            };
+            currentHistory.push(assistantMessage);
+            session.setHistory(currentHistory);
+            const result = {
+                message: maxIterMessage,
+                conversationHistory: currentHistory,
+                usageMetadata: latestUsage,
+                requestId: latestRequestId,
+                iterations: iteration,
+                summarized,
+            };
+            callbacks.onError?.({
+                code: 'MAX_ITERATIONS',
+                message: maxIterMessage,
+                recoverable: true,
+            });
+            callbacks.onComplete?.(result);
+            return result;
+        }
+        throw new AgentError('EMPTY_RESPONSE');
+    }
+    async function chat(message, context, callbacks = {}) {
+        logger.chatStart(message, session.getHistory().length);
+        const abortController = session.createAbortController();
+        const contextWithAbort = {
+            ...context,
+            abortSignal: context.abortSignal ?? abortController.signal,
+        };
+        let lastError;
+        let retryErrorTrace;
+        for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const result = await attemptProcessMessage(message, session.getHistory(), contextWithAbort, callbacks, retryErrorTrace);
+                session.clearAbortController();
+                return result;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error('Unknown error occurred');
+                console.error(`[Agent] Attempt ${attempt}/${MAX_RETRY_ATTEMPTS} failed:`, lastError);
+                if (isAbortError(error)) {
+                    logger.aborted();
+                    callbacks.onAborted?.();
+                    throw error;
+                }
+                const isConfigError = lastError instanceof AgentError &&
+                    (lastError.code === 'API_KEY_REQUIRED' || lastError.code === 'MODEL_REQUIRED');
+                const isEmptyResponse = lastError instanceof AgentError && lastError.code === 'EMPTY_RESPONSE';
+                const shouldRetry = attempt < MAX_RETRY_ATTEMPTS && !isConfigError && !isEmptyResponse;
+                if (!shouldRetry) {
+                    break;
+                }
+                retryErrorTrace = formatErrorTrace(lastError);
+                logger.retry(attempt + 1, MAX_RETRY_ATTEMPTS, lastError.message);
+            }
+        }
+        session.clearAbortController();
+        const errorMessage = resolveErrorMessage('GENERIC_ERROR');
+        callbacks.onError?.({
+            code: lastError instanceof AgentError ? lastError.code : 'GENERIC_ERROR',
+            message: lastError?.message ?? errorMessage,
+            recoverable: false,
+        });
+        return {
+            message: errorMessage,
+            conversationHistory: session.getHistory(),
+            usageMetadata: session.getTokenUsage(),
+            iterations: 0,
+            summarized: false,
+        };
+    }
+    function abort() {
+        session.abort();
+    }
+    function getHistory() {
+        return session.getHistory();
+    }
+    function setHistory(history) {
+        session.setHistory(history);
+    }
+    function clearHistory() {
+        session.clearHistory();
+    }
+    function getTokenUsage() {
+        return session.getTokenUsage();
+    }
+    return {
+        chat,
+        abort,
+        getHistory,
+        setHistory,
+        clearHistory,
+        getTokenUsage,
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/core/agent.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,16 @@
+import type { ErrorMessages } from '../types/index.js';
+export type AgentErrorCode = 'API_KEY_REQUIRED' | 'MODEL_REQUIRED' | 'EMPTY_RESPONSE' | 'REQUEST_ABORTED' | 'NO_RESPONSE' | 'NO_RESPONSE_MESSAGE' | 'MAX_ITERATIONS' | 'TOOL_EXECUTION_FAILED' | 'SUMMARIZATION_FAILED' | 'GENERIC_ERROR';
+export declare class AgentError extends Error {
+    readonly code: AgentErrorCode;
+    readonly recoverable: boolean;
+    constructor(code: AgentErrorCode, message?: string, recoverable?: boolean);
+    toJSON(): {
+        code: AgentErrorCode;
+        message: string;
+        recoverable: boolean;
+    };
+}
+export declare function createErrorMessageResolver(customMessages?: ErrorMessages): (code: AgentErrorCode) => string;
+export declare function formatErrorTrace(error: Error): string;
+export declare function isAbortError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,qBAAqB,GACrB,gBAAgB,GAChB,uBAAuB,GACvB,sBAAsB,GACtB,eAAe,CAAC;AAepB,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;gBAElB,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe;IAOhF,MAAM;;;;;CAOP;AAED,wBAAgB,0BAA0B,CAAC,cAAc,CAAC,EAAE,aAAa,IAC/D,MAAM,cAAc,KAAG,MAAM,CAgBtC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGrD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD"}

package/dist/core/errors.js

@@ -0,0 +1,55 @@
+const DEFAULT_ERROR_MESSAGES = {
+    API_KEY_REQUIRED: 'API key is required',
+    MODEL_REQUIRED: 'Model name is required',
+    EMPTY_RESPONSE: 'No response received, please try again',
+    REQUEST_ABORTED: 'Request aborted before processing',
+    NO_RESPONSE: 'No response received from API',
+    NO_RESPONSE_MESSAGE: 'No response message received from API',
+    MAX_ITERATIONS: 'Maximum iterations reached. Please break down your request into smaller parts.',
+    TOOL_EXECUTION_FAILED: 'Tool execution failed',
+    SUMMARIZATION_FAILED: 'Failed to summarize conversation',
+    GENERIC_ERROR: 'An internal error occurred, please try again later',
+};
+export class AgentError extends Error {
+    code;
+    recoverable;
+    constructor(code, message, recoverable = false) {
+        super(message || DEFAULT_ERROR_MESSAGES[code]);
+        this.name = 'AgentError';
+        this.code = code;
+        this.recoverable = recoverable;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            recoverable: this.recoverable,
+        };
+    }
+}
+export function createErrorMessageResolver(customMessages) {
+    return (code) => {
+        if (customMessages) {
+            const customKey = code.toLowerCase().replace(/_/g, '');
+            const customKeyAlt = code
+                .toLowerCase()
+                .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+            if (customMessages[customKey]) {
+                return customMessages[customKey];
+            }
+            if (customMessages[customKeyAlt]) {
+                return customMessages[customKeyAlt];
+            }
+        }
+        return DEFAULT_ERROR_MESSAGES[code];
+    };
+}
+export function formatErrorTrace(error) {
+    const trace = `${error.name ?? 'Error'}: ${JSON.stringify(error, null, 2)}\n`;
+    return `<INTERNAL_ERROR_TRACE>${trace}</INTERNAL_ERROR_TRACE>`;
+}
+export function isAbortError(error) {
+    return (error instanceof Error &&
+        (error.name === 'AbortError' || error.message === 'Request aborted before processing'));
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAcA,MAAM,sBAAsB,GAAmC;IAC7D,gBAAgB,EAAE,qBAAqB;IACvC,cAAc,EAAE,wBAAwB;IACxC,cAAc,EAAE,wCAAwC;IACxD,eAAe,EAAE,mCAAmC;IACpD,WAAW,EAAE,+BAA+B;IAC5C,mBAAmB,EAAE,uCAAuC;IAC5D,cAAc,EAAE,gFAAgF;IAChG,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,kCAAkC;IACxD,aAAa,EAAE,oDAAoD;CACpE,CAAC;AAEF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IACrB,WAAW,CAAU;IAE9B,YAAY,IAAoB,EAAE,OAAgB,EAAE,cAAuB,KAAK;QAC9E,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,cAA8B;IACvE,OAAO,CAAC,IAAoB,EAAU,EAAE;QACtC,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAwB,CAAC;YAC9E,MAAM,YAAY,GAAG,IAAI;iBACtB,WAAW,EAAE;iBACb,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAwB,CAAC;YAEpF,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,OAAO,cAAc,CAAC,SAAS,CAAE,CAAC;YACpC,CAAC;YACD,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,OAAO,cAAc,CAAC,YAAY,CAAE,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC9E,OAAO,yBAAyB,KAAK,yBAAyB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,KAAK,mCAAmC,CAAC,CACvF,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+export { createAgent } from './agent.js';
+export type { Agent } from './agent.js';
+export { createOpenRouterClient } from './openrouter-client.js';
+export type { OpenRouterClientConfig } from './openrouter-client.js';
+export { ToolExecutor } from './tool-executor.js';
+export { AgentSession } from './session.js';
+export { summarizeConversation, createSummaryMessage, shouldSummarize, DEFAULT_CONTEXT_LIMIT_TOKENS, } from './summarization.js';
+export type { SummarizationResult } from './summarization.js';
+export { AgentError, formatErrorTrace, isAbortError, createErrorMessageResolver, } from './errors.js';
+export type { AgentErrorCode } from './errors.js';
+export { convertChatMessagesToOpenAI, convertFunctionDeclarationsToTools, convertOpenAIToolCallsToFunctionCalls, mapOpenAIUsageToMetadata, normalizeReasoning, createSystemMessage, createUserMessage, createAssistantMessage, } from './openrouter-utils.js';
+export type { NormalizedReasoning } from './openrouter-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,8 @@
+export { createAgent } from './agent.js';
+export { createOpenRouterClient } from './openrouter-client.js';
+export { ToolExecutor } from './tool-executor.js';
+export { AgentSession } from './session.js';
+export { summarizeConversation, createSummaryMessage, shouldSummarize, DEFAULT_CONTEXT_LIMIT_TOKENS, } from './summarization.js';
+export { AgentError, formatErrorTrace, isAbortError, createErrorMessageResolver, } from './errors.js';
+export { convertChatMessagesToOpenAI, convertFunctionDeclarationsToTools, convertOpenAIToolCallsToFunctionCalls, mapOpenAIUsageToMetadata, normalizeReasoning, createSystemMessage, createUserMessage, createAssistantMessage, } from './openrouter-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,2BAA2B,EAC3B,kCAAkC,EAClC,qCAAqC,EACrC,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,24 @@
+export declare const logger: {
+    chatStart(message: string, historyLength: number): void;
+    iteration(current: number, max: number): void;
+    apiRequest(model: string, messageCount: number, hasTools: boolean): void;
+    apiResponse(hasText: boolean, toolCallCount: number, hasThinking: boolean): void;
+    toolCallStart(calls: Array<{
+        name: string;
+        args: Record<string, unknown>;
+    }>): void;
+    toolCallResult(name: string, result: unknown, error?: string): void;
+    thinking(hasThinking: boolean): void;
+    summarizationStart(messageCount: number): void;
+    summarizationEnd(tokensEstimate?: number): void;
+    tokenUsage(usage: {
+        promptTokenCount?: number;
+        responseTokenCount?: number;
+        totalTokenCount?: number;
+    }): void;
+    chatComplete(iterations: number, summarized: boolean): void;
+    error(message: string, error?: unknown): void;
+    aborted(): void;
+    retry(attempt: number, maxAttempts: number, reason: string): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,MAAM;uBACE,MAAM,iBAAiB,MAAM;uBAM7B,MAAM,OAAO,MAAM;sBAIpB,MAAM,gBAAgB,MAAM,YAAY,OAAO;yBAO5C,OAAO,iBAAiB,MAAM,eAAe,OAAO;yBAOpD,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;yBAOtD,MAAM,UAAU,OAAO,UAAU,MAAM;0BAStC,OAAO;qCAMI,MAAM;sCAIL,MAAM;sBAItB;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;6BAMwB,MAAM,cAAc,OAAO;mBAMrC,MAAM,UAAU,OAAO;;mBAWvB,MAAM,eAAe,MAAM,UAAU,MAAM;CAG3D,CAAC"}