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

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * 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 async function handleModelsList(rc) {
+    const queryString = rc.rawUrl.includes('?') ? rc.rawUrl.split('?')[1] : '';
+    const queryParams = new URLSearchParams(queryString);
+    const excludeEmbedding = queryParams.get('exclude_embedding') === 'true';
+    let data = [
+        { id: 'smart-agent', object: 'model', owned_by: 'smart-agent' },
+    ];
+    if (rc.modelProvider) {
+        const result = await rc.modelProvider.getModels({ excludeEmbedding });
+        if (result.ok) {
+            data = result.value.map((m) => ({
+                id: m.id,
+                object: 'model',
+                owned_by: m.owned_by ?? 'unknown',
+                ...(m.displayName ? { display_name: m.displayName } : {}),
+                ...(m.provider ? { provider: m.provider } : {}),
+                ...(m.capabilities ? { capabilities: m.capabilities } : {}),
+                ...(m.contextLength ? { context_length: m.contextLength } : {}),
+                ...(m.streamingSupported !== undefined
+                    ? { streaming_supported: m.streamingSupported }
+                    : {}),
+                ...(m.deprecated !== undefined ? { deprecated: m.deprecated } : {}),
+            }));
+        }
+    }
+    rc.res.writeHead(200, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify({ object: 'list', data }));
+}
+/**
+ * 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 async function handleEmbeddingModelsList(rc) {
+    let data = [];
+    if (rc.modelProvider?.getEmbeddingModels) {
+        const result = await rc.modelProvider.getEmbeddingModels();
+        if (result.ok) {
+            data = result.value.map((m) => ({
+                id: m.id,
+                object: 'model',
+                owned_by: m.owned_by ?? 'unknown',
+                ...(m.displayName ? { display_name: m.displayName } : {}),
+                ...(m.provider ? { provider: m.provider } : {}),
+                ...(m.capabilities ? { capabilities: m.capabilities } : {}),
+                ...(m.contextLength ? { context_length: m.contextLength } : {}),
+                ...(m.streamingSupported !== undefined
+                    ? { streaming_supported: m.streamingSupported }
+                    : {}),
+                ...(m.deprecated !== undefined ? { deprecated: m.deprecated } : {}),
+            }));
+        }
+    }
+    rc.res.writeHead(200, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify({ object: 'list', data }));
+}
+//# sourceMappingURL=models-route-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"models-route-handler.js","sourceRoot":"","sources":["../../../src/smart-agent/http/models-route-handler.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAgB;IACrD,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAC;IACzE,IAAI,IAAI,GAAmC;QACzC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE;KAChE,CAAC;IACF,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACtE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;gBACjC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,CAAC,CAAC,kBAAkB,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,kBAAkB,EAAE;oBAC/C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,EAAgB;IAEhB,IAAI,IAAI,GAAmC,EAAE,CAAC;IAC9C,IAAI,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QAC3D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,OAAO;gBACf,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;gBACjC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/D,GAAG,CAAC,CAAC,CAAC,kBAAkB,KAAK,SAAS;oBACpC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,kBAAkB,EAAE;oBAC/C,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/smart-agent/http/response-helpers.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure HTTP response helpers shared by SmartServer's route handlers.
+ *
+ * Relocated verbatim from `smart-server.ts` so the route table and the
+ * SmartServer methods can share them without duplicating logic. Behaviour is
+ * byte-identical to the originals; `smart-server.ts` re-exports them so import
+ * paths stay stable.
+ */
+import type { IncomingMessage } from 'node:http';
+import type { ExternalToolValidationCode } from '@mcp-abap-adt/llm-agent';
+import type { StopReason } from '@mcp-abap-adt/llm-agent-libs';
+export declare function mapStopReason(r: StopReason): 'stop' | 'length' | 'tool_calls';
+export declare function jsonError(message: string, type: string, code?: string): string;
+export declare function jsonValidationError(message: string, code: ExternalToolValidationCode, param: string): string;
+export declare function readBody(req: IncomingMessage): Promise<string>;
+export declare const CORS_HEADERS: {
+    'Access-Control-Allow-Origin': string;
+    'Access-Control-Allow-Methods': string;
+    'Access-Control-Allow-Headers': string;
+};
+/**
+ * Pre-dispatch readiness gate response: HTTP 503 with an OpenAI-shaped error,
+ * written BEFORE any pipeline run or SSE stream is opened. Used when the server is
+ * NOT_READY (MCP unavailable) so a request fails loud instead of being served
+ * tool-blind / returning a silent "(no response)".
+ */
+export declare function writeNotReady(res: {
+    writeHead(code: number, headers?: Record<string, string>): unknown;
+    end(body?: string): unknown;
+}): void;
+//# sourceMappingURL=response-helpers.d.ts.map

package/dist/smart-agent/http/response-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/response-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAI7E;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,0BAA0B,EAChC,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9D;AAED,eAAO,MAAM,YAAY;;;;CAIxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IACnE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B,GAAG,IAAI,CAUP"}

package/dist/smart-agent/http/response-helpers.js

@@ -0,0 +1,59 @@
+/**
+ * Pure HTTP response helpers shared by SmartServer's route handlers.
+ *
+ * Relocated verbatim from `smart-server.ts` so the route table and the
+ * SmartServer methods can share them without duplicating logic. Behaviour is
+ * byte-identical to the originals; `smart-server.ts` re-exports them so import
+ * paths stay stable.
+ */
+export function mapStopReason(r) {
+    if (r === 'stop')
+        return 'stop';
+    if (r === 'tool_calls')
+        return 'tool_calls';
+    return 'length';
+}
+export function jsonError(message, type, code) {
+    return JSON.stringify({
+        error: { message, type, ...(code ? { code } : {}) },
+    });
+}
+export function jsonValidationError(message, code, param) {
+    return JSON.stringify({
+        error: {
+            message,
+            type: 'invalid_request_error',
+            code,
+            param,
+        },
+    });
+}
+export function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+export const CORS_HEADERS = {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, PUT, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+};
+/**
+ * Pre-dispatch readiness gate response: HTTP 503 with an OpenAI-shaped error,
+ * written BEFORE any pipeline run or SSE stream is opened. Used when the server is
+ * NOT_READY (MCP unavailable) so a request fails loud instead of being served
+ * tool-blind / returning a silent "(no response)".
+ */
+export function writeNotReady(res) {
+    res.writeHead(503, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+        error: {
+            type: 'service_unavailable',
+            message: 'MCP unavailable — server not ready',
+        },
+    }));
+}
+//# sourceMappingURL=response-helpers.js.map

package/dist/smart-agent/http/response-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.js","sourceRoot":"","sources":["../../../src/smart-agent/http/response-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,UAAU,aAAa,CAAC,CAAa;IACzC,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAChC,IAAI,CAAC,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,IAAY,EACZ,IAAa;IAEb,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,IAAgC,EAChC,KAAa;IAEb,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE;YACL,OAAO;YACP,IAAI,EAAE,uBAAuB;YAC7B,IAAI;YACJ,KAAK;SACN;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAoB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,6BAA6B,EAAE,GAAG;IAClC,8BAA8B,EAAE,yBAAyB;IACzD,8BAA8B,EAAE,6BAA6B;CAC9D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAG7B;IACC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC3D,GAAG,CAAC,GAAG,CACL,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,EAAE;YACL,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,oCAAoC;SAC9C;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/smart-agent/http/route-table.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Declarative HTTP route table for SmartServer.
+ *
+ * Replaces the ~300-line if/else chain in `SmartServer._handle` with an ordered
+ * list of routes. Dispatch iterates the routes in registration order; the first
+ * route whose method AND path match handles the request. No match ⇒ 404. The
+ * order of `add()` calls is therefore semantically significant and MUST mirror
+ * the original `_handle` branch order to stay behaviour-preserving.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { ILlmApiAdapter, IModelProvider, IRequestLogger } from '@mcp-abap-adt/llm-agent';
+import type { HealthChecker, SmartAgent, SmartAgentHandle } from '@mcp-abap-adt/llm-agent-libs';
+import type { SmartServer } from '../smart-server.js';
+export interface RouteContext {
+    req: IncomingMessage;
+    res: ServerResponse;
+    rawUrl: string;
+    urlPath: string;
+    method: string;
+    /** Pre-computed once in `_handle`; reused by health/messages/chat. */
+    ready: boolean;
+    server: SmartServer;
+    requestLogger: IRequestLogger;
+    smartAgent: SmartAgent;
+    chat: SmartAgentHandle['chat'];
+    streamChat: SmartAgentHandle['streamChat'];
+    log: (e: Record<string, unknown>) => void;
+    healthChecker: HealthChecker;
+    modelProvider?: IModelProvider;
+    adapterMap?: Map<string, ILlmApiAdapter>;
+}
+export type RouteHandler = (rc: RouteContext) => Promise<void>;
+export interface IRoute {
+    /** HTTP method(s) this route serves, or `'*'` to match any method. */
+    method: string | string[];
+    match(urlPath: string): RegExpMatchArray | boolean;
+    handle: RouteHandler;
+}
+export declare class HttpRouteTable {
+    private readonly routes;
+    add(route: IRoute): this;
+    dispatch(rc: RouteContext): Promise<void>;
+}
+//# sourceMappingURL=route-table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-table.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/route-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,cAAc,CAAC;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1C,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/D,MAAM,WAAW,MAAM;IACrB,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC;IACnD,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlB,QAAQ,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBhD"}

package/dist/smart-agent/http/route-table.js

@@ -0,0 +1,35 @@
+/**
+ * Declarative HTTP route table for SmartServer.
+ *
+ * Replaces the ~300-line if/else chain in `SmartServer._handle` with an ordered
+ * list of routes. Dispatch iterates the routes in registration order; the first
+ * route whose method AND path match handles the request. No match ⇒ 404. The
+ * order of `add()` calls is therefore semantically significant and MUST mirror
+ * the original `_handle` branch order to stay behaviour-preserving.
+ */
+import { jsonError } from './response-helpers.js';
+export class HttpRouteTable {
+    routes = [];
+    add(route) {
+        this.routes.push(route);
+        return this;
+    }
+    async dispatch(rc) {
+        for (const route of this.routes) {
+            const methodOk = route.method === '*' ||
+                (Array.isArray(route.method)
+                    ? route.method.includes(rc.method)
+                    : route.method === rc.method);
+            if (!methodOk)
+                continue;
+            const m = route.match(rc.urlPath);
+            if (m) {
+                await route.handle(rc);
+                return;
+            }
+        }
+        rc.res.writeHead(404, { 'Content-Type': 'application/json' });
+        rc.res.end(jsonError(`Cannot ${rc.method} ${rc.urlPath}`, 'invalid_request_error'));
+    }
+}
+//# sourceMappingURL=route-table.js.map

package/dist/smart-agent/http/route-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../../../src/smart-agent/http/route-table.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA8BlD,MAAM,OAAO,cAAc;IACR,MAAM,GAAa,EAAE,CAAC;IAEvC,GAAG,CAAC,KAAa;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAgB;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,KAAK,GAAG;gBACpB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;oBAC1B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;oBAClC,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC;gBACN,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvB,OAAO;YACT,CAAC;QACH,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC9D,EAAE,CAAC,GAAG,CAAC,GAAG,CACR,SAAS,CAAC,UAAU,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CACxE,CAAC;IACJ,CAAC;CACF"}

package/dist/smart-agent/http/session-cookie.d.ts

@@ -0,0 +1,10 @@
+import type { SessionLifecycle } from '../session-lifecycle/index.js';
+import type { RouteContext } from './route-table.js';
+/**
+ * Resolve session identity from the request cookie and mint+set a Set-Cookie
+ * header when a new session id was minted. Extracted verbatim from the 7×
+ * repeated inline block in `_buildRouteTable` / `_withSession`. Returns the
+ * resolved identity so callers read `resolved.identity.sessionId`.
+ */
+export declare function resolveSessionCookie(rc: RouteContext, lifecycle: SessionLifecycle): ReturnType<SessionLifecycle['resolve']>;
+//# sourceMappingURL=session-cookie.d.ts.map

package/dist/smart-agent/http/session-cookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cookie.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/session-cookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,gBAAgB,GAC1B,UAAU,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CASzC"}

package/dist/smart-agent/http/session-cookie.js

@@ -0,0 +1,16 @@
+/**
+ * Resolve session identity from the request cookie and mint+set a Set-Cookie
+ * header when a new session id was minted. Extracted verbatim from the 7×
+ * repeated inline block in `_buildRouteTable` / `_withSession`. Returns the
+ * resolved identity so callers read `resolved.identity.sessionId`.
+ */
+export function resolveSessionCookie(rc, lifecycle) {
+    const isHttps = rc.req.socket.encrypted === true ||
+        rc.req.headers['x-forwarded-proto'] === 'https';
+    const resolved = lifecycle.resolve(rc.req.headers['cookie'], isHttps);
+    if (resolved.minted && resolved.setCookie) {
+        rc.res.setHeader('Set-Cookie', resolved.setCookie);
+    }
+    return resolved;
+}
+//# sourceMappingURL=session-cookie.js.map

package/dist/smart-agent/http/session-cookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cookie.js","sourceRoot":"","sources":["../../../src/smart-agent/http/session-cookie.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAgB,EAChB,SAA2B;IAE3B,MAAM,OAAO,GACV,EAAE,CAAC,GAAG,CAAC,MAAkC,CAAC,SAAS,KAAK,IAAI;QAC7D,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC;IAClD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { KnowledgeBackend } from '@mcp-abap-adt/llm-agent-libs';
+import { type SessionLifecycle } from '../session-lifecycle/index.js';
+import type { ISessionMetaStore } from '../session-meta-store.js';
+import type { RouteContext } from './route-table.js';
+export declare function handleSessionsList(rc: RouteContext, lifecycle: SessionLifecycle | undefined, metaStore: ISessionMetaStore): Promise<void>;
+export declare function handleSessionResume(rc: RouteContext, lifecycle: SessionLifecycle | undefined, metaStore: ISessionMetaStore): Promise<void>;
+export declare function handleSessionDelete(rc: RouteContext, lifecycle: SessionLifecycle | undefined, metaStore: ISessionMetaStore, knowledgeBackend: KnowledgeBackend | undefined): Promise<void>;
+//# sourceMappingURL=sessions-route-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/sessions-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,gBAAgB,GAAG,SAAS,EACvC,SAAS,EAAE,iBAAiB,EAC5B,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,GAC7C,OAAO,CAAC,IAAI,CAAC,CAwBf"}

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

@@ -0,0 +1,54 @@
+import { handleDeleteSession, handleListSessions, handleResumeSession, } from '../session-lifecycle/index.js';
+import { jsonError } from './response-helpers.js';
+import { resolveSessionCookie } from './session-cookie.js';
+export async function handleSessionsList(rc, lifecycle, metaStore) {
+    if (!lifecycle) {
+        rc.res.writeHead(500, { 'Content-Type': 'application/json' });
+        rc.res.end(jsonError('Session lifecycle not initialized', 'server_error'));
+        return;
+    }
+    const resolved = resolveSessionCookie(rc, lifecycle);
+    const identity = resolved.identity.sessionId;
+    const body = await handleListSessions(metaStore, identity);
+    rc.res.writeHead(200, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify(body));
+}
+export async function handleSessionResume(rc, lifecycle, metaStore) {
+    const resumeMatch = rc.urlPath.match(/^\/v1\/sessions\/([^/]+)\/resume$/);
+    if (!resumeMatch)
+        return;
+    const sessionId = resumeMatch[1];
+    if (!lifecycle) {
+        rc.res.writeHead(500, { 'Content-Type': 'application/json' });
+        rc.res.end(jsonError('Session lifecycle not initialized', 'server_error'));
+        return;
+    }
+    const resolved = resolveSessionCookie(rc, lifecycle);
+    const identity = resolved.identity.sessionId;
+    const body = await handleResumeSession(metaStore, identity, sessionId);
+    const status = body.ok ? 200 : 404;
+    rc.res.writeHead(status, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify(body));
+}
+export async function handleSessionDelete(rc, lifecycle, metaStore, knowledgeBackend) {
+    const deleteMatch = rc.urlPath.match(/^\/v1\/sessions\/([^/]+)$/);
+    if (!deleteMatch)
+        return;
+    const sessionId = deleteMatch[1];
+    if (!lifecycle) {
+        rc.res.writeHead(500, { 'Content-Type': 'application/json' });
+        rc.res.end(jsonError('Session lifecycle not initialized', 'server_error'));
+        return;
+    }
+    const resolved = resolveSessionCookie(rc, lifecycle);
+    const identity = resolved.identity.sessionId;
+    const evictFn = async (sid) => {
+        await lifecycle.registry.evictOne(sid);
+        await knowledgeBackend?.deleteSession(sid);
+    };
+    const body = await handleDeleteSession(metaStore, identity, sessionId, evictFn);
+    const status = body.ok ? 200 : 404;
+    rc.res.writeHead(status, { 'Content-Type': 'application/json' });
+    rc.res.end(JSON.stringify(body));
+}
+//# sourceMappingURL=sessions-route-handler.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { SessionLifecycle } from '../session-lifecycle/index.js';
+import type { RouteContext } from './route-table.js';
+/**
+ * GET /v1/usage — return per-session token-usage summary.
+ *
+ * Body moved verbatim from `SmartServer._buildRouteTable` (route index 2).
+ * `rc.server._lifecycle` (private) is threaded as the `lifecycle` param so the
+ * free function compiles without accessing private class fields.
+ * The inline cookie block is replaced with `resolveSessionCookie(rc, lifecycle)`.
+ */
+export declare function handleUsageRoute(rc: RouteContext, lifecycle: SessionLifecycle | undefined): Promise<void>;
+//# sourceMappingURL=usage-route-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage-route-handler.d.ts","sourceRoot":"","sources":["../../../src/smart-agent/http/usage-route-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,gBAAgB,GAAG,SAAS,GACtC,OAAO,CAAC,IAAI,CAAC,CAef"}