@mcp-abap-adt/llm-agent-server-libs 20.0.0 → 20.5.0

package/dist/smart-agent/http/chat-route-handler.js

@@ -0,0 +1,327 @@
+import { randomUUID } from 'node:crypto';
+import { buildExternalResults, normalizeAndValidateExternalTools, toToolCallDelta, } from '@mcp-abap-adt/llm-agent';
+import { SessionLogger, } from '@mcp-abap-adt/llm-agent-libs';
+import { jsonError, jsonValidationError, mapStopReason, readBody, } from './response-helpers.js';
+/**
+ * POST /v1/chat/completions handler (OpenAI-compatible), extracted verbatim
+ * from SmartServer._handleChat. The only change vs. the original is that the
+ * three `this.cfg` reads are now the trailing `cfg` parameter.
+ */
+export async function handleChat(req, res, _requestLogger, smartAgent, _chat, _streamChat, log, modelProvider, session, cfg) {
+    const rawBody = await readBody(req);
+    let parsed;
+    try {
+        parsed = JSON.parse(rawBody);
+    }
+    catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('Invalid JSON body', 'invalid_request_error'));
+        return;
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        !Array.isArray(parsed.messages)) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('messages must be a non-empty array', 'invalid_request_error'));
+        return;
+    }
+    const body = parsed;
+    const extractText = (c) => {
+        if (c === null || c === undefined)
+            return '';
+        if (typeof c === 'string')
+            return c;
+        if (!Array.isArray(c))
+            return '';
+        return c
+            .filter((b) => typeof b === 'object' &&
+            b !== null &&
+            b.type === 'text' &&
+            typeof b.text === 'string')
+            .map((b) => b.text)
+            .join('\n');
+    };
+    const userMessages = body.messages.filter((m) => m.role === 'user');
+    if (userMessages.length === 0) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('at least one message with role "user" is required', 'invalid_request_error'));
+        return;
+    }
+    // Prefer the session injected by `_withSession` (cookie identity); fall
+    // back to the legacy x-session-id header / 'default' bucket only when no
+    // session was wired (defensive — production routes always inject one).
+    const traceId = session?.traceId ?? randomUUID();
+    const sessionId = session?.sessionId ?? req.headers['x-session-id'] ?? 'default';
+    const sessionLogger = new SessionLogger(cfg.logDir || null, sessionId, traceId);
+    const toolsValidationMode = cfg.agent?.externalToolsValidationMode ?? 'permissive';
+    const externalToolsValidation = normalizeAndValidateExternalTools(body.tools);
+    const externalTools = externalToolsValidation.tools;
+    if (externalToolsValidation.errors.length > 0) {
+        log({
+            event: 'invalid_external_tools_detected',
+            traceId,
+            sessionId,
+            mode: toolsValidationMode,
+            count: externalToolsValidation.errors.length,
+            errors: externalToolsValidation.errors,
+        });
+        sessionLogger.logStep('invalid_external_tools_detected', {
+            mode: toolsValidationMode,
+            count: externalToolsValidation.errors.length,
+            errors: externalToolsValidation.errors,
+        });
+        if (toolsValidationMode === 'strict') {
+            const firstError = externalToolsValidation.errors[0];
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonValidationError(firstError.message, firstError.code, firstError.param));
+            return;
+        }
+    }
+    const t0 = Date.now();
+    log({ event: 'request_start', stream: body.stream ?? false, traceId });
+    const opts = {
+        stream: body.stream,
+        externalTools,
+        sessionId,
+        trace: { traceId },
+        sessionLogger,
+        model: body.model,
+        ...(session
+            ? {
+                toolAvailability: session.graph.toolAvailability,
+                pendingToolResults: session.graph.pendingToolResults,
+            }
+            : {}),
+        ...(body.temperature !== undefined
+            ? { temperature: body.temperature }
+            : {}),
+        ...(body.max_tokens !== undefined ? { maxTokens: body.max_tokens } : {}),
+        ...(body.top_p !== undefined ? { topP: body.top_p } : {}),
+        ...(body.stop !== undefined
+            ? { stop: Array.isArray(body.stop) ? body.stop : [body.stop] }
+            : {}),
+    };
+    const responseModel = body.model ?? modelProvider?.getModel() ?? 'smart-agent';
+    const normalizedMessages = body.messages
+        .map((m) => {
+        const role = m.role;
+        const normalizedMessage = {
+            role,
+            content: extractText(m.content),
+        };
+        if (role === 'tool') {
+            if (typeof m.tool_call_id === 'string' && m.tool_call_id.trim()) {
+                normalizedMessage.tool_call_id = m.tool_call_id;
+            }
+            else {
+                sessionLogger.logStep('drop_orphan_tool_message', {
+                    reason: 'missing_tool_call_id',
+                });
+                return null;
+            }
+        }
+        if (role === 'assistant' && Array.isArray(m.tool_calls)) {
+            const toolCalls = m.tool_calls
+                .filter((tc) => typeof tc === 'object' &&
+                tc !== null &&
+                typeof tc.id === 'string' &&
+                tc.type === 'function' &&
+                typeof tc.function
+                    ?.name === 'string' &&
+                typeof tc.function
+                    ?.arguments === 'string')
+                .map((tc) => ({
+                id: tc.id,
+                type: 'function',
+                function: {
+                    name: tc.function.name,
+                    arguments: tc.function.arguments,
+                },
+            }));
+            if (toolCalls.length > 0) {
+                normalizedMessage.tool_calls = toolCalls;
+                if (!normalizedMessage.content)
+                    normalizedMessage.content = null;
+            }
+        }
+        return normalizedMessage;
+    })
+        .filter((m) => m !== null);
+    // #171 (review#11): consume external (client-executed) tool result turns
+    // from the incoming history into a validated `extId → result` map and strip
+    // those raw turns from the messages forwarded to the agent (so no internal
+    // LLM call ever sees an unmatched assistant tool_calls). On a normal request
+    // with no external history this returns the messages unchanged + an empty
+    // map — a safe no-op. The map is threaded via options.externalResults.
+    const { results: externalResults, sanitizedMessages } = buildExternalResults(normalizedMessages);
+    const invalidToolsHeader = externalToolsValidation.errors.length > 0
+        ? {
+            'x-smartagent-invalid-tools': String(externalToolsValidation.errors.length),
+        }
+        : {};
+    if (body.stream) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            ...invalidToolsHeader,
+        });
+        const id = `chatcmpl-${randomUUID()}`;
+        const created = Math.floor(Date.now() / 1000);
+        const stream = smartAgent.streamProcess(sanitizedMessages, {
+            ...opts,
+            externalResults,
+        });
+        let firstChunk = true;
+        let finishReasonSent = false;
+        let lastUsage = null;
+        for await (const chunk of stream) {
+            if (!chunk.ok) {
+                const errorChunk = {
+                    id,
+                    object: 'chat.completion.chunk',
+                    created,
+                    model: responseModel,
+                    choices: [
+                        {
+                            index: 0,
+                            delta: { content: `[Error] ${chunk.error.message}` },
+                            finish_reason: 'stop',
+                        },
+                    ],
+                };
+                res.write(`data: ${JSON.stringify(errorChunk)}\n\n`);
+                finishReasonSent = true;
+                break;
+            }
+            // SSE heartbeat comment — keeps connection alive, ignored by clients
+            if (chunk.value.heartbeat) {
+                const hb = chunk.value.heartbeat;
+                res.write(`: heartbeat tool=${hb.tool} elapsed=${hb.elapsed}ms\n\n`);
+                continue;
+            }
+            // SSE timing breakdown comment — sent with the final chunk
+            if (chunk.value.timing) {
+                const parts = chunk.value.timing.map((t) => `${t.phase}=${t.duration}ms`);
+                res.write(`: timing ${parts.join(' ')}\n\n`);
+            }
+            if (chunk.value.usage) {
+                lastUsage = {
+                    prompt_tokens: chunk.value.usage.promptTokens,
+                    completion_tokens: chunk.value.usage.completionTokens,
+                    total_tokens: chunk.value.usage.totalTokens,
+                };
+            }
+            const baseResponse = {
+                id,
+                object: 'chat.completion.chunk',
+                created,
+                model: responseModel,
+                usage: null,
+            };
+            if (firstChunk) {
+                res.write(`data: ${JSON.stringify({ ...baseResponse, choices: [{ index: 0, delta: { role: 'assistant', content: chunk.value.content || '' }, finish_reason: null }] })}\n\n`);
+                firstChunk = false;
+                if (!chunk.value.finishReason && !chunk.value.toolCalls)
+                    continue;
+            }
+            if (chunk.value.content || chunk.value.toolCalls) {
+                const delta = {};
+                if (chunk.value.content)
+                    delta.content = chunk.value.content;
+                if (chunk.value.toolCalls) {
+                    delta.tool_calls = chunk.value.toolCalls.map((call, index) => {
+                        const tc = toToolCallDelta(call, index);
+                        return {
+                            index: tc.index,
+                            id: tc.id,
+                            type: 'function',
+                            function: {
+                                name: tc.name,
+                                arguments: tc.arguments || '',
+                            },
+                        };
+                    });
+                }
+                res.write(`data: ${JSON.stringify({ ...baseResponse, choices: [{ index: 0, delta, finish_reason: null }] })}\n\n`);
+            }
+            if (chunk.value.finishReason) {
+                res.write(`data: ${JSON.stringify({ ...baseResponse, choices: [{ index: 0, delta: {}, finish_reason: mapStopReason(chunk.value.finishReason) }] })}\n\n`);
+                finishReasonSent = true;
+            }
+        }
+        if (!finishReasonSent) {
+            const baseResponse = {
+                id,
+                object: 'chat.completion.chunk',
+                created,
+                model: responseModel,
+                usage: null,
+            };
+            res.write(`data: ${JSON.stringify({ ...baseResponse, choices: [{ index: 0, delta: {}, finish_reason: 'stop' }] })}\n\n`);
+        }
+        if ((cfg.reportUsage !== false || body.stream_options?.include_usage) &&
+            lastUsage) {
+            res.write(`data: ${JSON.stringify({ id, object: 'chat.completion.chunk', created, model: responseModel, choices: [], usage: lastUsage })}\n\n`);
+        }
+        res.write('data: [DONE]\n\n');
+        res.end();
+        log({
+            event: 'request_done',
+            ok: true,
+            stream: true,
+            finishReason: finishReasonSent ? 'sent' : 'fallback_stop',
+            durationMs: Date.now() - t0,
+        });
+        return;
+    }
+    const result = await smartAgent.process(sanitizedMessages, {
+        ...opts,
+        externalResults,
+    });
+    log({ event: 'request_done', ok: result.ok, durationMs: Date.now() - t0 });
+    const finalContent = result.ok
+        ? result.value.content || (result.value.toolCalls ? null : '(no response)')
+        : `Error: ${result.error.message}`;
+    const finalFinishReason = result.ok
+        ? mapStopReason(result.value.stopReason)
+        : 'stop';
+    let finalUsage = null;
+    if (result.ok && result.value.usage) {
+        finalUsage = {
+            prompt_tokens: result.value.usage.promptTokens,
+            completion_tokens: result.value.usage.completionTokens,
+            total_tokens: result.value.usage.totalTokens,
+        };
+    }
+    const message = {
+        role: 'assistant',
+        content: finalContent,
+    };
+    if (result.ok && result.value.toolCalls) {
+        message.tool_calls = result.value.toolCalls;
+    }
+    res.writeHead(200, {
+        'Content-Type': 'application/json',
+        ...invalidToolsHeader,
+    });
+    res.end(JSON.stringify({
+        id: `chatcmpl-${randomUUID()}`,
+        object: 'chat.completion',
+        created: Math.floor(Date.now() / 1000),
+        model: responseModel,
+        choices: [
+            {
+                index: 0,
+                message,
+                finish_reason: finalFinishReason,
+            },
+        ],
+        usage: finalUsage || {
+            prompt_tokens: 0,
+            completion_tokens: 0,
+            total_tokens: 0,
+        },
+    }));
+}
+//# sourceMappingURL=chat-route-handler.js.map

package/dist/smart-agent/http/chat-route-handler.js.map

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

package/dist/smart-agent/http/config-route-handler.d.ts

@@ -0,0 +1,21 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ILlm, IModelResolver } from '@mcp-abap-adt/llm-agent';
+import type { SmartAgent } from '@mcp-abap-adt/llm-agent-libs';
+/** Exactly the SmartServer state PUT /v1/config touches — the hot-swap seam. */
+export interface IConfigUpdateTarget {
+    readonly modelResolver?: IModelResolver;
+    setMainLlm(llm: ILlm): void;
+    setClassifierLlm(llm: ILlm): void;
+    setHelperLlm(llm: ILlm): void;
+    /** Deep-merge `patch` into the mirrored `cfg.agent` (preserve untouched startup fields). */
+    mirrorAgentCfg(patch: Record<string, unknown>): void;
+    drainWorkers(): Promise<void>;
+    invalidateSessions(): Promise<void>;
+}
+/**
+ * PUT /v1/config handler, extracted verbatim from SmartServer._handleConfigUpdate.
+ * SmartServer state is reached through `target` (IConfigUpdateTarget): the LLM
+ * setters ARE the hot-swap that RoleLlmResolver's live accessors observe.
+ */
+export declare function handleConfigUpdate(req: IncomingMessage, res: ServerResponse, smartAgent: SmartAgent, target: IConfigUpdateTarget): Promise<void>;
+//# sourceMappingURL=config-route-handler.d.ts.map

package/dist/smart-agent/http/config-route-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/config-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,8BAA8B,CAAC;AAGtC,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,UAAU,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IAC5B,gBAAgB,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,4FAA4F;IAC5F,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAaD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Jf"}

package/dist/smart-agent/http/config-route-handler.js

@@ -0,0 +1,149 @@
+import { jsonError, readBody } from './response-helpers.js';
+/** Whitelisted agent config fields allowed via PUT /v1/config. */
+const AGENT_CONFIG_FIELDS = new Set([
+    'maxIterations',
+    'maxToolCalls',
+    'ragQueryK',
+    'toolUnavailableTtlMs',
+    'showReasoning',
+    'historyAutoSummarizeLimit',
+    'classificationEnabled',
+]);
+/**
+ * PUT /v1/config handler, extracted verbatim from SmartServer._handleConfigUpdate.
+ * SmartServer state is reached through `target` (IConfigUpdateTarget): the LLM
+ * setters ARE the hot-swap that RoleLlmResolver's live accessors observe.
+ */
+export async function handleConfigUpdate(req, res, smartAgent, target) {
+    const raw = await readBody(req);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('Invalid JSON body', 'invalid_request_error'));
+        return;
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('Request body must be a JSON object', 'invalid_request_error'));
+        return;
+    }
+    const body = parsed;
+    // --- Validate agent fields against whitelist ---
+    if (body.agent !== undefined) {
+        if (typeof body.agent !== 'object' ||
+            body.agent === null ||
+            Array.isArray(body.agent)) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonError('"agent" must be a JSON object', 'invalid_request_error'));
+            return;
+        }
+        const agentFields = body.agent;
+        const unsupported = Object.keys(agentFields).filter((k) => !AGENT_CONFIG_FIELDS.has(k));
+        if (unsupported.length > 0) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonError(`Unsupported agent config fields: ${unsupported.join(', ')}`, 'invalid_request_error'));
+            return;
+        }
+    }
+    // --- Validate and resolve models (atomic: resolve ALL before mutating) ---
+    let resolvedModels;
+    if (body.models !== undefined) {
+        if (typeof body.models !== 'object' ||
+            body.models === null ||
+            Array.isArray(body.models)) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonError('"models" must be a JSON object', 'invalid_request_error'));
+            return;
+        }
+        if (!target.modelResolver) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonError('model resolver not configured', 'invalid_request_error'));
+            return;
+        }
+        const modelFields = body.models;
+        const validKeys = new Set(['mainModel', 'classifierModel', 'helperModel']);
+        const unknownKeys = Object.keys(modelFields).filter((k) => !validKeys.has(k));
+        if (unknownKeys.length > 0) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(jsonError(`Unknown model fields: ${unknownKeys.join(', ')}`, 'invalid_request_error'));
+            return;
+        }
+        try {
+            const resolver = target.modelResolver;
+            const [mainLlm, classifierLlm, helperLlm] = await Promise.all([
+                modelFields.mainModel
+                    ? resolver.resolve(String(modelFields.mainModel), 'main')
+                    : undefined,
+                modelFields.classifierModel
+                    ? resolver.resolve(String(modelFields.classifierModel), 'classifier')
+                    : undefined,
+                modelFields.helperModel
+                    ? resolver.resolve(String(modelFields.helperModel), 'helper')
+                    : undefined,
+            ]);
+            resolvedModels = {};
+            if (mainLlm)
+                resolvedModels.mainLlm = mainLlm;
+            if (classifierLlm)
+                resolvedModels.classifierLlm = classifierLlm;
+            if (helperLlm)
+                resolvedModels.helperLlm = helperLlm;
+        }
+        catch (err) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(jsonError(String(err), 'server_error'));
+            return;
+        }
+    }
+    // --- All validation passed — apply mutations ---
+    if (resolvedModels) {
+        smartAgent.reconfigure(resolvedModels);
+        // Mirror onto the hoisted globals consumed by `buildSessionAgent` so
+        // freshly-built session graphs pick up the new LLMs by reference
+        // (otherwise `this._mainLlm` etc. would keep pointing at the originals
+        // captured during `start()`).
+        if (resolvedModels.mainLlm)
+            target.setMainLlm(resolvedModels.mainLlm);
+        if (resolvedModels.classifierLlm)
+            target.setClassifierLlm(resolvedModels.classifierLlm);
+        if (resolvedModels.helperLlm)
+            target.setHelperLlm(resolvedModels.helperLlm);
+    }
+    if (body.agent) {
+        const patch = body.agent;
+        smartAgent.applyConfigUpdate(patch);
+        // Mirror onto `this.cfg.agent` so freshly-built session graphs (which
+        // read `this.cfg.agent` in `buildSessionAgent`) observe the update.
+        // Deep-merge to preserve untouched startup fields; replacing the whole
+        // `agent` block would drop YAML defaults the validator already applied.
+        target.mirrorAgentCfg(patch);
+    }
+    // Invalidate per-session SmartAgents + the worker-LLM cache so the next
+    // request mints a session graph that observes the just-applied config.
+    // Without this, chat routes dispatch to `graph.agent` (the per-session
+    // SmartAgent) which was built with the OLD config, and the PUT is a
+    // no-op from the consumer's perspective. Failures are non-fatal so the
+    // 200 response isn't blocked by a dispose hiccup.
+    if (resolvedModels || body.agent) {
+        // Fix #21: drain per-worker SmartAgentHandle.close() BEFORE clearing the
+        // cache so MCP clients owned by the discarded handles disconnect.
+        await target.drainWorkers();
+        try {
+            await target.invalidateSessions();
+        }
+        catch {
+            // Swallow: cleanup errors must not turn a successful config update
+            // into a 500. The next request will still get a fresh build because
+            // `_workers.cache` is already cleared and dispose is idempotent.
+        }
+    }
+    // --- Return updated config ---
+    const models = smartAgent.getActiveConfig();
+    const agent = smartAgent.getAgentConfig();
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ models, agent }));
+}
+//# sourceMappingURL=config-route-handler.js.map

package/dist/smart-agent/http/config-route-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-route-handler.js","sourceRoot":"","sources":["../../../src/smart-agent/http/config-route-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAc5D,kEAAkE;AAClE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,eAAe;IACf,cAAc;IACd,WAAW;IACX,sBAAsB;IACtB,eAAe;IACf,2BAA2B;IAC3B,uBAAuB;CACxB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAoB,EACpB,GAAmB,EACnB,UAAsB,EACtB,MAA2B;IAE3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CAAC,oCAAoC,EAAE,uBAAuB,CAAC,CACzE,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,MAAiC,CAAC;IAE/C,kDAAkD;IAClD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,IACE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAC9B,IAAI,CAAC,KAAK,KAAK,IAAI;YACnB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EACzB,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CAAC,+BAA+B,EAAE,uBAAuB,CAAC,CACpE,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAgC,CAAC;QAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CACnC,CAAC;QACF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CACP,oCAAoC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC5D,uBAAuB,CACxB,CACF,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,IAAI,cAAwD,CAAC;IAC7D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IACE,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;YAC/B,IAAI,CAAC,MAAM,KAAK,IAAI;YACpB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAC1B,CAAC;YACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CAAC,gCAAgC,EAAE,uBAAuB,CAAC,CACrE,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC1B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CAAC,+BAA+B,EAAE,uBAAuB,CAAC,CACpE,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAiC,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;QAC3E,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CACzB,CAAC;QACF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CACL,SAAS,CACP,yBAAyB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACjD,uBAAuB,CACxB,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC;YACtC,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC5D,WAAW,CAAC,SAAS;oBACnB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;oBACzD,CAAC,CAAC,SAAS;gBACb,WAAW,CAAC,eAAe;oBACzB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,YAAY,CAAC;oBACrE,CAAC,CAAC,SAAS;gBACb,WAAW,CAAC,WAAW;oBACrB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;oBAC7D,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;YACH,cAAc,GAAG,EAAE,CAAC;YACpB,IAAI,OAAO;gBAAE,cAAc,CAAC,OAAO,GAAG,OAAO,CAAC;YAC9C,IAAI,aAAa;gBAAE,cAAc,CAAC,aAAa,GAAG,aAAa,CAAC;YAChE,IAAI,SAAS;gBAAE,cAAc,CAAC,SAAS,GAAG,SAAS,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,cAAc,EAAE,CAAC;QACnB,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QACvC,qEAAqE;QACrE,iEAAiE;QACjE,uEAAuE;QACvE,8BAA8B;QAC9B,IAAI,cAAc,CAAC,OAAO;YAAE,MAAM,CAAC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,cAAc,CAAC,aAAa;YAC9B,MAAM,CAAC,gBAAgB,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,cAAc,CAAC,SAAS;YAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAgC,CAAC;QACpD,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACpC,sEAAsE;QACtE,oEAAoE;QACpE,uEAAuE;QACvE,wEAAwE;QACxE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,wEAAwE;IACxE,uEAAuE;IACvE,uEAAuE;IACvE,oEAAoE;IACpE,uEAAuE;IACvE,kDAAkD;IAClD,IAAI,cAAc,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,yEAAyE;QACzE,kEAAkE;QAClE,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,oEAAoE;YACpE,iEAAiE;QACnE,CAAC;IACH,CAAC;IACD,gCAAgC;IAChC,MAAM,MAAM,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;IAC1C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/smart-agent/http/health-route-handler.d.ts

@@ -0,0 +1,12 @@
+import type { RouteContext } from './route-table.js';
+/**
+ * GET /health | /v1/health — return server + MCP health status.
+ *
+ * Body moved verbatim from `SmartServer._buildRouteTable` (route index 6).
+ * Reads only `rc.healthChecker`, `rc.ready`, and `rc.res` — no private server
+ * fields, so no threading is required.
+ * MCP-down ⇒ NOT_READY ⇒ 503 (not just LLM-unhealthy), so a load balancer
+ * stops routing while MCP is unreachable.
+ */
+export declare function handleHealthRoute(rc: RouteContext): Promise<void>;
+//# sourceMappingURL=health-route-handler.d.ts.map

package/dist/smart-agent/http/health-route-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/health-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE"}

package/dist/smart-agent/http/health-route-handler.js

@@ -0,0 +1,19 @@
+/**
+ * GET /health | /v1/health — return server + MCP health status.
+ *
+ * Body moved verbatim from `SmartServer._buildRouteTable` (route index 6).
+ * Reads only `rc.healthChecker`, `rc.ready`, and `rc.res` — no private server
+ * fields, so no threading is required.
+ * MCP-down ⇒ NOT_READY ⇒ 503 (not just LLM-unhealthy), so a load balancer
+ * stops routing while MCP is unreachable.
+ */
+export async function handleHealthRoute(rc) {
+    const status = await rc.healthChecker.check();
+    // 503 == NOT READY (can't serve, e.g. MCP down). LLM/RAG/circuit soft
+    // signals surface in the body (status: degraded) but do NOT 503 a service
+    // that can still serve — a load balancer must not drop a working pod.
+    const httpCode = rc.ready ? 200 : 503;
+    rc.res.writeHead(httpCode, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify({ ...status, ready: rc.ready }));
+}
+//# sourceMappingURL=health-route-handler.js.map

package/dist/smart-agent/http/health-route-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-route-handler.js","sourceRoot":"","sources":["../../../src/smart-agent/http/health-route-handler.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAgB;IACtD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC9C,sEAAsE;IACtE,0EAA0E;IAC1E,sEAAsE;IACtE,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACnE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/smart-agent/http/models-route-handler.d.ts

@@ -0,0 +1,17 @@
+import type { RouteContext } from './route-table.js';
+/**
+ * GET /v1/models | /models — list LLM models available through this server.
+ *
+ * Body moved verbatim from `SmartServer._buildRouteTable` (route index 0).
+ * Reads only `rc.rawUrl`, `rc.modelProvider`, and `rc.res` — no private server
+ * fields, so no threading is required.
+ */
+export declare function handleModelsList(rc: RouteContext): Promise<void>;
+/**
+ * GET /v1/embedding-models | /embedding-models — list embedding models.
+ *
+ * Body moved verbatim from `SmartServer._buildRouteTable` (route index 1).
+ * Reads only `rc.modelProvider` and `rc.res`.
+ */
+export declare function handleEmbeddingModelsList(rc: RouteContext): Promise<void>;
+//# sourceMappingURL=models-route-handler.d.ts.map

package/dist/smart-agent/http/models-route-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/models-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtE;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,YAAY,GACf,OAAO,CAAC,IAAI,CAAC,CAsBf"}