@jsonstudio/rcc 0.85.9

package/dist/server/handlers/handler-utils.js

@@ -0,0 +1,227 @@
+import { Readable } from 'node:stream';
+import { mapErrorToHttp } from '../utils/http-error-mapper.js';
+import { logPipelineStage } from '../utils/stage-logger.js';
+const BLOCKED_HEADERS = new Set(['content-length', 'transfer-encoding', 'connection', 'content-encoding']);
+const CLIENT_HEADER_DENYLIST = new Set([
+    'host',
+    'connection',
+    'content-length',
+    'accept-encoding',
+    'authorization',
+    'proxy-authorization',
+    'upgrade',
+    'te'
+]);
+function hasSsePayload(body) {
+    return Boolean(body && typeof body === 'object' && '__sse_responses' in body);
+}
+export function nextRequestId(candidate) {
+    if (typeof candidate === 'string' && candidate.trim().length > 0) {
+        return candidate.trim();
+    }
+    if (Array.isArray(candidate) && candidate[0]) {
+        return String(candidate[0]);
+    }
+    return `req-v2-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+export function sendPipelineResponse(res, result, requestId, options) {
+    const status = typeof result.status === 'number' ? result.status : 200;
+    let body = result.body;
+    const requestLabel = requestId || 'unknown';
+    const forceSSE = options?.forceSSE === true;
+    let expectsStream = hasSsePayload(body);
+    if (forceSSE && !expectsStream) {
+        logPipelineStage('response.sse.missing', requestLabel, { status });
+        res.status(502).json({ error: { message: 'SSE stream missing from pipeline result', code: 'sse_bridge_error' } });
+        return;
+    }
+    logPipelineStage('response.dispatch.start', requestLabel, { status, stream: expectsStream, forced: forceSSE });
+    if (expectsStream) {
+        const stream = toNodeReadable(body.__sse_responses);
+        if (!stream) {
+            logPipelineStage('response.sse.missing', requestLabel, {});
+            res.status(502).json({ error: { message: 'SSE stream missing from pipeline result', code: 'sse_bridge_error' } });
+            return;
+        }
+        applyHeaders(res, result.headers, true);
+        res.status(status);
+        res.setHeader('Content-Type', 'text/event-stream; charset=utf-8');
+        res.setHeader('Cache-Control', 'no-cache, no-transform');
+        res.setHeader('Connection', 'keep-alive');
+        if (typeof res.flushHeaders === 'function') {
+            res.flushHeaders();
+        }
+        else if (typeof res.flush === 'function') {
+            res.flush();
+        }
+        console.log(`[sse][${requestLabel}] streaming response started (status=${status})`);
+        logPipelineStage('response.sse.stream.start', requestLabel, { status });
+        let eventCount = 0;
+        const previewLimit = 3;
+        const cleanup = () => {
+            try {
+                stream.destroy?.();
+            }
+            catch {
+                /* ignore cleanup errors */
+            }
+            console.log(`[sse][${requestLabel}] streaming response finished (events=${eventCount})`);
+            logPipelineStage('response.sse.stream.end', requestLabel, { events: eventCount, status });
+        };
+        stream.on('error', (error) => {
+            logPipelineStage('response.sse.stream.error', requestLabel, { message: error.message });
+            try {
+                res.write(`event: error\ndata: ${JSON.stringify({ message: error.message })}\n\n`);
+            }
+            catch {
+                /* ignore write errors */
+            }
+            try {
+                res.end();
+            }
+            catch {
+                /* ignore end errors */
+            }
+        });
+        stream.on('data', (chunk) => {
+            eventCount++;
+            if (eventCount <= previewLimit) {
+                try {
+                    const text = typeof chunk === 'string' ? chunk : chunk?.toString?.('utf8');
+                    if (text) {
+                        const trimmed = text.length > 200 ? `${text.slice(0, 200)}…` : text;
+                        console.log(`[sse][${requestLabel}] event #${eventCount}: ${trimmed}`);
+                    }
+                }
+                catch {
+                    /* ignore preview errors */
+                }
+            }
+        });
+        res.on('close', cleanup);
+        res.on('finish', cleanup);
+        stream.pipe(res);
+        return;
+    }
+    applyHeaders(res, result.headers, false);
+    if (body === undefined || body === null) {
+        logPipelineStage('response.json.empty', requestLabel, { status });
+        res.status(status).end();
+        logPipelineStage('response.json.completed', requestLabel, { status });
+        return;
+    }
+    logPipelineStage('response.json.write', requestLabel, { status });
+    res.status(status).json(body);
+    logPipelineStage('response.json.completed', requestLabel, { status });
+}
+export function logRequestStart(endpoint, requestId, meta) {
+    const suffix = formatMeta(meta);
+    console.log(`➡️  [${endpoint}] request ${requestId}${suffix}`);
+}
+export function logRequestComplete(endpoint, requestId, status) {
+    console.log(`✅ [${endpoint}] request ${requestId} completed (status=${status})`);
+}
+export function logRequestError(endpoint, requestId, error) {
+    const message = error instanceof Error ? error.message : String(error ?? 'Unknown error');
+    console.error(`❌ [${endpoint}] request ${requestId} failed: ${message}`);
+}
+export async function respondWithPipelineError(res, ctx, error, entryEndpoint, requestId) {
+    const normalizedError = normalizeError(error, requestId, entryEndpoint);
+    const errorHandler = ctx.errorHandling?.handleError;
+    if (typeof errorHandler === 'function') {
+        try {
+            await errorHandler({
+                error: normalizedError,
+                source: 'http-handler',
+                severity: 'error',
+                moduleId: 'http-handler',
+                requestId,
+                metadata: {
+                    endpoint: entryEndpoint
+                }
+            });
+        }
+        catch {
+            /* ignore error center failures */
+        }
+    }
+    const mapped = mapErrorToHttp(normalizedError);
+    if (requestId && mapped.body?.error && !mapped.body.error.request_id) {
+        mapped.body.error.request_id = requestId;
+    }
+    res.status(mapped.status).json(mapped.body);
+}
+function applyHeaders(res, headers, omitContentType) {
+    if (!headers) {
+        return;
+    }
+    for (const [key, value] of Object.entries(headers)) {
+        if (typeof value !== 'string')
+            continue;
+        const normalized = key.toLowerCase();
+        if (BLOCKED_HEADERS.has(normalized))
+            continue;
+        if (omitContentType && normalized === 'content-type')
+            continue;
+        res.setHeader(key, value);
+    }
+}
+function toNodeReadable(streamLike) {
+    if (!streamLike) {
+        return null;
+    }
+    if (typeof streamLike.pipe === 'function') {
+        return streamLike;
+    }
+    if (typeof streamLike.getReader === 'function') {
+        try {
+            return Readable.fromWeb(streamLike);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (typeof streamLike[Symbol.asyncIterator] === 'function') {
+        return Readable.from(streamLike);
+    }
+    return null;
+}
+export function captureClientHeaders(headers) {
+    const result = {};
+    if (!headers)
+        return result;
+    for (const [key, value] of Object.entries(headers)) {
+        if (!value)
+            continue;
+        const normalized = key.toLowerCase();
+        if (CLIENT_HEADER_DENYLIST.has(normalized))
+            continue;
+        if (Array.isArray(value)) {
+            if (value[0])
+                result[key] = String(value[0]);
+        }
+        else if (typeof value === 'string') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function normalizeError(error, requestId, endpoint) {
+    const err = error instanceof Error ? error : new Error(String(error ?? 'Unknown error'));
+    const enriched = err;
+    if (!enriched.requestId)
+        enriched.requestId = requestId;
+    if (!enriched.endpoint)
+        enriched.endpoint = endpoint;
+    return enriched;
+}
+function formatMeta(meta) {
+    if (!meta || typeof meta !== 'object') {
+        return '';
+    }
+    const entries = Object.entries(meta)
+        .filter(([_, value]) => value !== undefined && value !== null && value !== '')
+        .map(([key, value]) => `${key}=${typeof value === 'object' ? JSON.stringify(value) : value}`);
+    return entries.length ? ` (${entries.join(', ')})` : '';
+}
+//# sourceMappingURL=handler-utils.js.map

package/dist/server/handlers/handler-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-utils.js","sourceRoot":"","sources":["../../../src/server/handlers/handler-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC3G,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,MAAM;IACN,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,qBAAqB;IACrB,SAAS;IACT,IAAI;CACL,CAAC,CAAC;AAYH,SAAS,aAAa,CAAC,IAAa;IAClC,OAAO,OAAO,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,iBAAiB,IAAK,IAAgC,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAmB;IAC/C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAa,EACb,MAA+B,EAC/B,SAAkB,EAClB,OAAyB;IAEzB,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACvE,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACvB,MAAM,YAAY,GAAG,SAAS,IAAI,SAAS,CAAC;IAC5C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,IAAI,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QAC/B,gBAAgB,CAAC,sBAAsB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAClH,OAAO;IACT,CAAC;IAED,gBAAgB,CAAC,yBAAyB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE/G,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,cAAc,CAAE,IAAY,CAAC,eAAe,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,gBAAgB,CAAC,sBAAsB,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAClH,OAAO;QACT,CAAC;QACD,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAC;QAClE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;QACzD,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAI,OAAQ,GAAW,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YACnD,GAAW,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC;aAAM,IAAI,OAAQ,GAAW,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACnD,GAAW,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,wCAAwC,MAAM,GAAG,CAAC,CAAC;QACpF,gBAAgB,CAAC,2BAA2B,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAExE,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,YAAY,GAAG,CAAC,CAAC;QAEvB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,yCAAyC,UAAU,GAAG,CAAC,CAAC;YACzF,gBAAgB,CAAC,yBAAyB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAClC,gBAAgB,CAAC,2BAA2B,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxF,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;YACrF,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;YACD,IAAI,CAAC;gBACH,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAU,EAAE,EAAE;YAC/B,UAAU,EAAE,CAAC;YACb,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;oBAC3E,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;wBACpE,OAAO,CAAC,GAAG,CAAC,SAAS,YAAY,YAAY,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;oBACzE,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACxC,gBAAgB,CAAC,qBAAqB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,gBAAgB,CAAC,yBAAyB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IACD,gBAAgB,CAAC,qBAAqB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,gBAAgB,CAAC,yBAAyB,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,SAAiB,EAAE,IAAqB;IACxF,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,QAAQ,QAAQ,aAAa,SAAS,GAAG,MAAM,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,SAAiB,EAAE,MAAc;IACpF,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,aAAa,SAAS,sBAAsB,MAAM,GAAG,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,SAAiB,EAAE,KAAc;IACjF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;IAC1F,OAAO,CAAC,KAAK,CAAC,MAAM,QAAQ,aAAa,SAAS,YAAY,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAa,EACb,GAAmB,EACnB,KAAc,EACd,aAAqB,EACrB,SAAiB;IAEjB,MAAM,eAAe,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC;IACpD,IAAI,OAAO,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAO,YAAsE,CAAC;gBAC5E,KAAK,EAAE,eAAe;gBACtB,MAAM,EAAE,cAAc;gBACtB,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,cAAc;gBACxB,SAAS;gBACT,QAAQ,EAAE;oBACR,QAAQ,EAAE,aAAa;iBACxB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;IAC3C,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,GAAa,EAAE,OAA2C,EAAE,eAAwB;IACxG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAC9C,IAAI,eAAe,IAAI,UAAU,KAAK,cAAc;YAAE,SAAS;QAC/D,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,UAAmB;IACzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACnD,OAAO,UAAsB,CAAC;IAChC,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAiB,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,IAAI,OAAQ,UAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,EAAE,CAAC;QACpE,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAoC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAwC;IAC3E,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,sBAAsB,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,CAAC,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,SAAiB,EAAE,QAAgB;IACzE,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,GAAsC,CAAC;IACxD,IAAI,CAAC,QAAQ,CAAC,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACxD,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,IAAqB;IACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;SAC7E,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAChG,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/server/handlers/messages-handler.d.ts

@@ -0,0 +1,7 @@
+import type { Request, Response } from 'express';
+import type { HandlerContext } from './types.js';
+export declare function handleMessages(req: Request, res: Response, ctx: HandlerContext): Promise<void>;
+declare const _default: {
+    handleMessages: typeof handleMessages;
+};
+export default _default;

package/dist/server/handlers/messages-handler.js

@@ -0,0 +1,58 @@
+import { nextRequestId, respondWithPipelineError, sendPipelineResponse, logRequestStart, logRequestComplete, logRequestError, captureClientHeaders } from './handler-utils.js';
+import { applySystemPromptOverride } from '../../utils/system-prompt-loader.js';
+export async function handleMessages(req, res, ctx) {
+    const entryEndpoint = '/v1/messages';
+    const requestId = nextRequestId(req.headers['x-request-id']);
+    try {
+        if (!ctx.executePipeline) {
+            res.status(503).json({ error: { message: 'Hub pipeline runtime not initialized' } });
+            return;
+        }
+        const payload = (req.body || {});
+        const originalPayload = payload && typeof payload === 'object' ? JSON.parse(JSON.stringify(payload)) : payload;
+        const clientHeaders = captureClientHeaders(req.headers);
+        const acceptsSse = typeof req.headers['accept'] === 'string'
+            && req.headers['accept'].includes('text/event-stream');
+        const originalStream = payload?.stream === true;
+        const inboundStream = acceptsSse || originalStream;
+        const outboundStream = originalStream;
+        if (acceptsSse && payload && typeof payload === 'object' && !originalStream) {
+            payload.stream = true;
+        }
+        const wantsStream = inboundStream;
+        applySystemPromptOverride(entryEndpoint, payload);
+        logRequestStart(entryEndpoint, requestId, {
+            inboundStream: wantsStream,
+            outboundStream,
+            clientAcceptsSse: acceptsSse,
+            originalStream,
+            model: payload?.model
+        });
+        const result = await ctx.executePipeline({
+            entryEndpoint,
+            method: req.method,
+            requestId,
+            headers: req.headers,
+            query: req.query,
+            body: payload,
+            metadata: {
+                stream: wantsStream,
+                clientStream: acceptsSse || undefined,
+                inboundStream: wantsStream,
+                outboundStream,
+                __raw_request_body: originalPayload,
+                clientHeaders
+            }
+        });
+        logRequestComplete(entryEndpoint, requestId, result.status ?? 200);
+        sendPipelineResponse(res, result, requestId, { forceSSE: wantsStream });
+    }
+    catch (error) {
+        logRequestError(entryEndpoint, requestId, error);
+        if (res.headersSent)
+            return;
+        await respondWithPipelineError(res, ctx, error, entryEndpoint, requestId);
+    }
+}
+export default { handleMessages };
+//# sourceMappingURL=messages-handler.js.map

package/dist/server/handlers/messages-handler.js.map

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

package/dist/server/handlers/responses-handler.d.ts

@@ -0,0 +1,12 @@
+import type { Request, Response } from 'express';
+import type { HandlerContext } from './types.js';
+interface ResponsesHandlerOptions {
+    entryEndpoint?: string;
+    forceStream?: boolean;
+    responseIdFromPath?: string;
+}
+export declare function handleResponses(req: Request, res: Response, ctx: HandlerContext, options?: ResponsesHandlerOptions): Promise<void>;
+declare const _default: {
+    handleResponses: typeof handleResponses;
+};
+export default _default;

package/dist/server/handlers/responses-handler.js

@@ -0,0 +1,85 @@
+import { nextRequestId, respondWithPipelineError, sendPipelineResponse, logRequestStart, logRequestComplete, logRequestError, captureClientHeaders } from './handler-utils.js';
+import { resumeResponsesConversation } from '../../modules/llmswitch/bridge.js';
+import { applySystemPromptOverride } from '../../utils/system-prompt-loader.js';
+export async function handleResponses(req, res, ctx, options = {}) {
+    const entryEndpoint = options.entryEndpoint || '/v1/responses';
+    const requestId = nextRequestId(req.headers['x-request-id']);
+    try {
+        if (!ctx.executePipeline) {
+            res.status(503).json({ error: { message: 'Hub pipeline runtime not initialized' } });
+            return;
+        }
+        let payload = (req.body || {});
+        const originalPayload = payload && typeof payload === 'object' ? JSON.parse(JSON.stringify(payload)) : payload;
+        if (options.responseIdFromPath && payload && typeof payload === 'object' && !payload.response_id) {
+            payload.response_id = options.responseIdFromPath;
+        }
+        const clientHeaders = captureClientHeaders(req.headers);
+        const acceptsSse = typeof req.headers['accept'] === 'string'
+            && req.headers['accept'].includes('text/event-stream');
+        const originalStream = payload?.stream === true;
+        const inboundStream = acceptsSse || originalStream;
+        const outboundStream = originalStream;
+        let resumeMeta;
+        if (entryEndpoint === '/v1/responses.submit_tool_outputs') {
+            const responseId = typeof payload?.response_id === 'string'
+                ? payload.response_id
+                : options.responseIdFromPath;
+            if (!responseId) {
+                res.status(400).json({ error: { message: 'response_id is required for submit_tool_outputs', type: 'invalid_request_error' } });
+                return;
+            }
+            try {
+                const resumeResult = await resumeResponsesConversation(responseId, payload, { requestId });
+                payload = resumeResult.payload;
+                resumeMeta = resumeResult.meta;
+            }
+            catch (error) {
+                const message = typeof error?.message === 'string' ? error.message : 'Unable to resume Responses conversation';
+                res.status(400).json({ error: { message, type: 'invalid_request_error', code: 'responses_resume_failed' } });
+                return;
+            }
+        }
+        if ((acceptsSse || options.forceStream) && payload && typeof payload === 'object' && (!originalStream || options.forceStream)) {
+            payload.stream = true;
+        }
+        const wantsStream = options.forceStream ?? inboundStream;
+        if (entryEndpoint === '/v1/responses') {
+            applySystemPromptOverride(entryEndpoint, payload);
+        }
+        logRequestStart(entryEndpoint, requestId, {
+            inboundStream: wantsStream,
+            outboundStream,
+            clientAcceptsSse: acceptsSse,
+            originalStream,
+            type: payload?.type
+        });
+        const result = await ctx.executePipeline({
+            entryEndpoint,
+            method: req.method,
+            requestId,
+            headers: req.headers,
+            query: req.query,
+            body: payload,
+            metadata: {
+                stream: wantsStream,
+                clientStream: acceptsSse || undefined,
+                inboundStream: wantsStream,
+                outboundStream,
+                __raw_request_body: originalPayload,
+                clientHeaders,
+                responsesResume: resumeMeta
+            }
+        });
+        logRequestComplete(entryEndpoint, requestId, result.status ?? 200);
+        sendPipelineResponse(res, result, requestId, { forceSSE: wantsStream });
+    }
+    catch (error) {
+        logRequestError(entryEndpoint, requestId, error);
+        if (res.headersSent)
+            return;
+        await respondWithPipelineError(res, ctx, error, entryEndpoint, requestId);
+    }
+}
+export default { handleResponses };
+//# sourceMappingURL=responses-handler.js.map

package/dist/server/handlers/responses-handler.js.map

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

package/dist/server/handlers/types.d.ts

@@ -0,0 +1,21 @@
+import type { Request, Response } from 'express';
+import type { ErrorHandlingCenter } from 'rcc-errorhandling';
+export interface PipelineExecutionInput {
+    entryEndpoint: string;
+    method: string;
+    requestId: string;
+    headers: Record<string, unknown>;
+    query: Record<string, unknown>;
+    body: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface PipelineExecutionResult {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export interface HandlerContext {
+    executePipeline: ((input: PipelineExecutionInput) => Promise<PipelineExecutionResult>) | null;
+    errorHandling?: ErrorHandlingCenter | null;
+}
+export type EndpointHandler = (req: Request, res: Response, ctx: HandlerContext) => Promise<void>;

package/dist/server/handlers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/handlers/types.ts"],"names":[],"mappings":""}

package/dist/server/runtime/http-server/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * RouteCodex Server V2 - 渐进式重构版本
+ *
+ * 核心特性：
+ * - 与现有V1服务器完全并行
+ * - 集成系统hooks模块
+ * - 模块化设计，职责分离
+ * - 保持API兼容性
+ */
+import type { ServerConfigV2, ServerStatusV2 } from './types.js';
+/**
+ * RouteCodex Server V2
+ *
+ * 与V1完全并行实现，集成系统hooks
+ */
+export declare class RouteCodexHttpServer {
+    private app;
+    private server?;
+    private config;
+    private errorHandling;
+    private _isInitialized;
+    private _isRunning;
+    private hubPipeline;
+    private providerHandles;
+    private providerKeyToRuntimeKey;
+    private pipelineLogger;
+    private authResolver;
+    private userConfig;
+    private moduleDependencies;
+    private hubPipelineCtor;
+    private readonly stageLoggingEnabled;
+    private readonly repoRoot;
+    private currentRouterArtifacts;
+    constructor(config: ServerConfigV2);
+    private resolveVirtualRouterInput;
+    private getModuleDependencies;
+    private createDebugCenterShim;
+    private logStage;
+    private normalizeAuthType;
+    private resolveSecretValue;
+    private bootstrapVirtualRouter;
+    private ensureHubPipelineCtor;
+    private isPipelineReady;
+    /**
+     * 初始化服务器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 启动服务器
+     */
+    start(): Promise<void>;
+    /**
+     * 停止服务器
+     */
+    stop(): Promise<void>;
+    /**
+     * 获取服务器状态
+     */
+    getStatus(): ServerStatusV2;
+    getServerConfig(): {
+        host: string;
+        port: number;
+    };
+    /**
+     * V1兼容接口：检查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * V1兼容接口：检查是否正在运行
+     */
+    isRunning(): boolean;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    initializeWithUserConfig(userConfig: any): Promise<void>;
+    reloadRuntime(userConfig: any): Promise<void>;
+    private setupRuntime;
+    private buildHandlerContext;
+    private initializeProviderRuntimes;
+    private createProviderHandle;
+    private materializeRuntimeProfile;
+    private normalizeRuntimeBaseUrl;
+    private resolveRuntimeAuth;
+    private resolveApiKeyValue;
+    private disposeProviders;
+    private executePipeline;
+    private runHubPipeline;
+    private buildRequestMetadata;
+    private extractRouteHint;
+    private normalizeProviderResponse;
+    private normalizeProviderResponseHeaders;
+    private convertProviderResponseIfNeeded;
+    private extractClientModelId;
+    private cloneRequestPayload;
+}