@mcp-abap-adt/llm-agent-server-libs 19.2.0 → 20.4.0

package/dist/smart-agent/controller/usage-logging.js

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------------------------
+// Debug logging — private copy (mirrors the one in controller-coordinator-handler.ts
+// to avoid creating an inverted dependency back to the handler).
+// ---------------------------------------------------------------------------
+function dlog(msg) {
+    if (process.env.DEBUG_CONTROLLER)
+        console.error(`[controller] ${msg}`);
+}
+/**
+ * Build a request-time `logUsage(role, usage)` that writes each subagent call
+ * into the per-request `IRequestLogger` (the single aggregator), attributing the
+ * role's configured model. The role is explicit at the call site, so the shared
+ * planner/finalizer client is attributed correctly. `durationMs: 0` — the seam
+ * carries no timing (matches the rag-query precedent).
+ */
+export function makeLogUsage(requestLogger, requestId, models) {
+    return (role, u) => {
+        if (!u)
+            return;
+        const model = role === 'finalizer'
+            ? (models.finalizer ?? models.planner)
+            : role === 'reviewer'
+                ? (models.reviewer ?? models.planner)
+                : role === 'embedding'
+                    ? 'embedder'
+                    : (models[role] ?? 'unknown');
+        requestLogger.logLlmCall({
+            component: role,
+            model,
+            promptTokens: u.promptTokens ?? 0,
+            completionTokens: u.completionTokens ?? 0,
+            totalTokens: u.totalTokens ?? 0,
+            durationMs: 0,
+            requestId,
+        });
+        dlog(`tokens ${role}: prompt=${u.promptTokens} completion=${u.completionTokens} total=${u.totalTokens}`);
+    };
+}
+//# sourceMappingURL=usage-logging.js.map

package/dist/smart-agent/controller/usage-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-logging.js","sourceRoot":"","sources":["../../../src/smart-agent/controller/usage-logging.ts"],"names":[],"mappings":"AAMA,8EAA8E;AAC9E,qFAAqF;AACrF,iEAAiE;AACjE,8EAA8E;AAE9E,SAAS,IAAI,CAAC,GAAW;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,aAA6B,EAC7B,SAA6B,EAC7B,MAMC;IAED,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACjB,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,MAAM,KAAK,GACT,IAAI,KAAK,WAAW;YAClB,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;YACtC,CAAC,CAAC,IAAI,KAAK,UAAU;gBACnB,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC;gBACrC,CAAC,CAAC,IAAI,KAAK,WAAW;oBACpB,CAAC,CAAC,UAAU;oBACZ,CAAC,CAAC,CAAE,MAAiC,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,CAAC;QAClE,aAAa,CAAC,UAAU,CAAC;YACvB,SAAS,EAAE,IAAoB;YAC/B,KAAK;YACL,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC;YACjC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,IAAI,CAAC;YACzC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC;YAC/B,UAAU,EAAE,CAAC;YACb,SAAS;SACV,CAAC,CAAC;QACH,IAAI,CACF,UAAU,IAAI,YAAY,CAAC,CAAC,YAAY,eAAe,CAAC,CAAC,gBAAgB,UAAU,CAAC,CAAC,WAAW,EAAE,CACnG,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type ILlmApiAdapter } from '@mcp-abap-adt/llm-agent';
+import type { SessionGraph, SmartAgent } from '@mcp-abap-adt/llm-agent-libs';
+/**
+ * POST /v1/messages handler (Anthropic adapter route), extracted verbatim from
+ * SmartServer._handleAdapterRequest. Pure — no SmartServer state is touched.
+ */
+export declare function handleAdapterRequest(req: IncomingMessage, res: ServerResponse, agent: SmartAgent, adapter: ILlmApiAdapter, session?: {
+    sessionId: string;
+    traceId: string;
+    graph: SessionGraph;
+}): Promise<void>;
+//# sourceMappingURL=adapter-route-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/adapter-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG7E;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACpE,OAAO,CAAC,IAAI,CAAC,CAmFf"}

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

@@ -0,0 +1,76 @@
+import { AdapterValidationError, buildExternalResults, } from '@mcp-abap-adt/llm-agent';
+import { jsonError, readBody } from './response-helpers.js';
+/**
+ * POST /v1/messages handler (Anthropic adapter route), extracted verbatim from
+ * SmartServer._handleAdapterRequest. Pure — no SmartServer state is touched.
+ */
+export async function handleAdapterRequest(req, res, agent, adapter, session) {
+    const raw = await readBody(req);
+    let body;
+    try {
+        body = JSON.parse(raw);
+    }
+    catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(jsonError('Invalid JSON', 'invalid_request_error'));
+        return;
+    }
+    let normalized;
+    try {
+        normalized = adapter.normalizeRequest(body);
+    }
+    catch (err) {
+        if (err instanceof AdapterValidationError) {
+            res.writeHead(err.statusCode, { 'Content-Type': 'application/json' });
+            res.end(jsonError(err.message, 'invalid_request_error'));
+            return;
+        }
+        throw err;
+    }
+    // #171 (review#8): the adapter has already normalized Anthropic
+    // tool_use/tool_result blocks into the OpenAI-shaped Message[]
+    // (assistant.tool_calls + role:'tool' with tool_call_id). Run the same
+    // external-results extraction the OpenAI path uses so Anthropic clients get
+    // identical stateless-resume behaviour: consumed external turns are stripped
+    // and their results threaded to the agent keyed by deterministic `ext:` id.
+    const { results: externalResults, sanitizedMessages } = buildExternalResults(normalized.messages);
+    const augmentedOptions = session
+        ? {
+            ...normalized.options,
+            sessionId: session.sessionId,
+            trace: { traceId: session.traceId },
+            toolAvailability: session.graph.toolAvailability,
+            pendingToolResults: session.graph.pendingToolResults,
+            externalResults,
+        }
+        : { ...normalized.options, externalResults };
+    if (normalized.stream) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+        });
+        for await (const event of adapter.transformStream(agent.streamProcess(sanitizedMessages, augmentedOptions), normalized.context)) {
+            const eventLine = event.event ? `event: ${event.event}\n` : '';
+            res.write(`${eventLine}data: ${event.data}\n\n`);
+        }
+        res.end();
+        return;
+    }
+    // Non-streaming
+    const result = await agent.process(sanitizedMessages, augmentedOptions);
+    res.setHeader('Content-Type', 'application/json');
+    if (!result.ok) {
+        res.writeHead(500);
+        res.end(JSON.stringify(adapter.formatError?.(result.error, normalized.context) ?? {
+            error: {
+                message: result.error.message,
+                type: result.error.code,
+            },
+        }));
+        return;
+    }
+    res.writeHead(200);
+    res.end(JSON.stringify(adapter.formatResult(result.value, normalized.context)));
+}
+//# sourceMappingURL=adapter-route-handler.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type IModelProvider, type IRequestLogger } from '@mcp-abap-adt/llm-agent';
+import { type SessionGraph, type SmartAgent, type SmartAgentHandle } from '@mcp-abap-adt/llm-agent-libs';
+import type { SmartServerConfig } from '../smart-server.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 declare function handleChat(req: IncomingMessage, res: ServerResponse, _requestLogger: IRequestLogger, smartAgent: SmartAgent, _chat: SmartAgentHandle['chat'], _streamChat: SmartAgentHandle['streamChat'], log: (e: Record<string, unknown>) => void, modelProvider: IModelProvider | undefined, session: {
+    sessionId: string;
+    traceId: string;
+    graph: SessionGraph;
+} | undefined, cfg: SmartServerConfig): Promise<void>;
+//# sourceMappingURL=chat-route-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/chat-route-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EAKpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQ5D;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC/B,WAAW,EAAE,gBAAgB,CAAC,YAAY,CAAC,EAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACzC,aAAa,EAAE,cAAc,GAAG,SAAS,EACzC,OAAO,EACH;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC3D,SAAS,EACb,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CAyZf"}

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"}