@windrun-huaiin/backend-core 15.1.0 → 16.0.0

package/dist/services/ai/openrouter-client.js

@@ -0,0 +1,81 @@
+'use strict';
+
+var tslib = require('tslib');
+var error = require('./error.js');
+
+const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+function callOpenRouterStream(config, body, signal) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const fetchImpl = (_a = config.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        const response = yield fetchImpl(`${(_b = config.baseUrl) !== null && _b !== void 0 ? _b : OPENROUTER_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            signal,
+            headers: Object.assign(Object.assign({ Authorization: `Bearer ${config.apiKey}`, 'Content-Type': 'application/json' }, (config.referer ? { 'HTTP-Referer': config.referer } : {})), (config.title ? { 'X-Title': config.title } : {})),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok || !response.body) {
+            let errorData = null;
+            try {
+                errorData = yield response.clone().json();
+            }
+            catch (_c) {
+                errorData = { message: response.statusText };
+            }
+            throw Object.assign({ status: response.status, message: response.statusText }, ((typeof errorData === 'object' && errorData !== null) ? errorData : {}));
+        }
+        return {
+            response,
+            status: response.status,
+        };
+    });
+}
+function guardedOpenRouterStreamStart(response) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+        if (!reader) {
+            return {
+                ok: false,
+                error: error.normalizeAIError(new Error('Empty upstream response body')),
+            };
+        }
+        const firstChunk = yield reader.read();
+        if (firstChunk.done || !firstChunk.value) {
+            return {
+                ok: false,
+                error: {
+                    error: 'AI returned an empty response',
+                    status: 'failed',
+                    failureReason: 'empty_response',
+                    upstreamStatusCode: response.status,
+                },
+            };
+        }
+        const stream = new ReadableStream({
+            start(controller) {
+                controller.enqueue(firstChunk.value);
+            },
+            pull(controller) {
+                return tslib.__awaiter(this, void 0, void 0, function* () {
+                    const nextChunk = yield reader.read();
+                    if (nextChunk.done) {
+                        controller.close();
+                        return;
+                    }
+                    controller.enqueue(nextChunk.value);
+                });
+            },
+            cancel(reason) {
+                void reader.cancel(reason);
+            },
+        });
+        return {
+            ok: true,
+            stream,
+        };
+    });
+}
+
+exports.callOpenRouterStream = callOpenRouterStream;
+exports.guardedOpenRouterStreamStart = guardedOpenRouterStreamStart;

package/dist/services/ai/openrouter-client.mjs

@@ -0,0 +1,78 @@
+import { __awaiter } from 'tslib';
+import { normalizeAIError } from './error.mjs';
+
+const OPENROUTER_BASE_URL = 'https://openrouter.ai/api/v1';
+function callOpenRouterStream(config, body, signal) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const fetchImpl = (_a = config.fetchImpl) !== null && _a !== void 0 ? _a : fetch;
+        const response = yield fetchImpl(`${(_b = config.baseUrl) !== null && _b !== void 0 ? _b : OPENROUTER_BASE_URL}/chat/completions`, {
+            method: 'POST',
+            signal,
+            headers: Object.assign(Object.assign({ Authorization: `Bearer ${config.apiKey}`, 'Content-Type': 'application/json' }, (config.referer ? { 'HTTP-Referer': config.referer } : {})), (config.title ? { 'X-Title': config.title } : {})),
+            body: JSON.stringify(body),
+        });
+        if (!response.ok || !response.body) {
+            let errorData = null;
+            try {
+                errorData = yield response.clone().json();
+            }
+            catch (_c) {
+                errorData = { message: response.statusText };
+            }
+            throw Object.assign({ status: response.status, message: response.statusText }, ((typeof errorData === 'object' && errorData !== null) ? errorData : {}));
+        }
+        return {
+            response,
+            status: response.status,
+        };
+    });
+}
+function guardedOpenRouterStreamStart(response) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+        if (!reader) {
+            return {
+                ok: false,
+                error: normalizeAIError(new Error('Empty upstream response body')),
+            };
+        }
+        const firstChunk = yield reader.read();
+        if (firstChunk.done || !firstChunk.value) {
+            return {
+                ok: false,
+                error: {
+                    error: 'AI returned an empty response',
+                    status: 'failed',
+                    failureReason: 'empty_response',
+                    upstreamStatusCode: response.status,
+                },
+            };
+        }
+        const stream = new ReadableStream({
+            start(controller) {
+                controller.enqueue(firstChunk.value);
+            },
+            pull(controller) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const nextChunk = yield reader.read();
+                    if (nextChunk.done) {
+                        controller.close();
+                        return;
+                    }
+                    controller.enqueue(nextChunk.value);
+                });
+            },
+            cancel(reason) {
+                void reader.cancel(reason);
+            },
+        });
+        return {
+            ok: true,
+            stream,
+        };
+    });
+}
+
+export { callOpenRouterStream, guardedOpenRouterStreamStart };

package/dist/services/ai/route.d.ts

@@ -0,0 +1,6 @@
+import type { AIRouteConfig } from './types';
+export declare const runtime = "edge";
+export declare const dynamic = "force-dynamic";
+export declare const revalidate = 0;
+export declare function createOpenRouterRoute(config: AIRouteConfig): (request: Request) => Promise<Response>;
+//# sourceMappingURL=route.d.ts.map

package/dist/services/ai/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/services/ai/route.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAC;AAE/D,eAAO,MAAM,OAAO,SAAS,CAAC;AAC9B,eAAO,MAAM,OAAO,kBAAkB,CAAC;AACvC,eAAO,MAAM,UAAU,IAAI,CAAC;AA8F5B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,IAG9B,SAAS,OAAO,uBA0G5C"}

package/dist/services/ai/route.js

@@ -0,0 +1,178 @@
+'use strict';
+
+var tslib = require('tslib');
+var ai = require('@windrun-huaiin/contracts/ai');
+var abort = require('./abort.js');
+var env = require('./env.js');
+var error = require('./error.js');
+var messageBuilder = require('./message-builder.js');
+var openrouterClient = require('./openrouter-client.js');
+
+const runtime = 'edge';
+const dynamic = 'force-dynamic';
+const revalidate = 0;
+const streamingHeaders = {
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate, no-transform',
+    Connection: 'keep-alive',
+    Pragma: 'no-cache',
+    'X-Accel-Buffering': 'no',
+};
+function createRequestId() {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    }
+}
+function encodeEvent(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+function createEventStream(response, messageId) {
+    return tslib.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const encoder = new TextEncoder();
+        const decoder = new TextDecoder();
+        const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+        if (!reader) {
+            throw new Error('Missing upstream reader');
+        }
+        return new ReadableStream({
+            start(controller) {
+                return tslib.__awaiter(this, void 0, void 0, function* () {
+                    controller.enqueue(encoder.encode(encodeEvent({
+                        type: 'message_started',
+                        messageId,
+                        createdAt: Date.now(),
+                    })));
+                    try {
+                        for (;;) {
+                            const chunk = yield reader.read();
+                            if (chunk.done) {
+                                break;
+                            }
+                            const text = decoder.decode(chunk.value, { stream: true });
+                            if (!text) {
+                                continue;
+                            }
+                            controller.enqueue(encoder.encode(encodeEvent({
+                                type: 'text_delta',
+                                messageId,
+                                text,
+                            })));
+                        }
+                        controller.enqueue(encoder.encode(encodeEvent({
+                            type: 'message_completed',
+                            messageId,
+                            createdAt: Date.now(),
+                        })));
+                        controller.close();
+                    }
+                    catch (error$1) {
+                        controller.enqueue(encoder.encode(encodeEvent({
+                            type: 'error',
+                            error: error.normalizeAIError(error$1),
+                        })));
+                        controller.close();
+                    }
+                });
+            },
+            cancel(reason) {
+                void reader.cancel(reason);
+            },
+        });
+    });
+}
+function createOpenRouterRoute(config) {
+    const openRouterConfig = env.createOpenRouterClientConfigFromEnv(config.openRouter);
+    return function POST(request) {
+        return tslib.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+            const parsedBody = ai.AIRuntimeRequestSchema.safeParse(yield request.json());
+            if (!parsedBody.success) {
+                const payload = ai.createAIErrorPayload({
+                    message: 'Invalid AI runtime request body',
+                    upstreamStatusCode: 400,
+                    failureReason: 'invalid_request',
+                });
+                return Response.json(payload, { status: 400 });
+            }
+            const requestId = createRequestId();
+            const sessionId = (_a = parsedBody.data.sessionId) !== null && _a !== void 0 ? _a : ((_c = (_b = config.createSessionId) === null || _b === void 0 ? void 0 : _b.call(config)) !== null && _c !== void 0 ? _c : createRequestId());
+            const context = {
+                request,
+                input: parsedBody.data,
+                sessionId,
+                requestId,
+                startedAt: Date.now(),
+                metadata: parsedBody.data.metadata,
+            };
+            const mockHandler = (_d = config.mock) !== null && _d !== void 0 ? _d : env.createOpenRouterMockFromEnvForContext(context);
+            try {
+                yield ((_g = (_f = (_e = config.adapters) === null || _e === void 0 ? void 0 : _e.billing) === null || _f === void 0 ? void 0 : _f.reserve) === null || _g === void 0 ? void 0 : _g.call(_f, context));
+                yield ((_j = (_h = config.hooks) === null || _h === void 0 ? void 0 : _h.beforeCall) === null || _j === void 0 ? void 0 : _j.call(_h, context));
+                if (mockHandler) {
+                    const mockResponse = yield mockHandler(context);
+                    if (mockResponse) {
+                        return mockResponse;
+                    }
+                }
+                const runUpstream = () => tslib.__awaiter(this, void 0, void 0, function* () {
+                    var _a, _b, _c, _d;
+                    const upstreamSignal = abort.createUpstreamAbortSignal(request.signal, (_b = (_a = config.timeoutMs) !== null && _a !== void 0 ? _a : openRouterConfig.timeoutMs) !== null && _b !== void 0 ? _b : 60000);
+                    const response = yield openrouterClient.callOpenRouterStream(openRouterConfig, {
+                        model: (_c = parsedBody.data.modelName) !== null && _c !== void 0 ? _c : openRouterConfig.defaultModel,
+                        messages: ((_d = config.buildModelMessages) !== null && _d !== void 0 ? _d : messageBuilder.buildModelMessages)(parsedBody.data.messages),
+                        stream: true,
+                        provider: openRouterConfig.provider,
+                        temperature: openRouterConfig.temperature,
+                        max_tokens: openRouterConfig.maxTokens,
+                    }, upstreamSignal);
+                    return response.response;
+                });
+                const upstreamResponse = ((_l = (_k = config.adapters) === null || _k === void 0 ? void 0 : _k.lock) === null || _l === void 0 ? void 0 : _l.withLock)
+                    ? yield config.adapters.lock.withLock(`ai:${sessionId}`, runUpstream)
+                    : yield runUpstream();
+                const guarded = yield openrouterClient.guardedOpenRouterStreamStart(upstreamResponse);
+                if (!guarded.ok) {
+                    yield ((_o = (_m = config.hooks) === null || _m === void 0 ? void 0 : _m.onError) === null || _o === void 0 ? void 0 : _o.call(_m, context, guarded.error));
+                    yield ((_r = (_q = (_p = config.adapters) === null || _p === void 0 ? void 0 : _p.billing) === null || _q === void 0 ? void 0 : _q.settle) === null || _r === void 0 ? void 0 : _r.call(_q, context, {
+                        status: guarded.error.status,
+                        upstreamStatusCode: guarded.error.upstreamStatusCode,
+                    }));
+                    return Response.json(guarded.error, {
+                        status: (_s = guarded.error.upstreamStatusCode) !== null && _s !== void 0 ? _s : 500,
+                    });
+                }
+                const messageId = `asst-${requestId}`;
+                const wrappedResponse = new Response(config.streamToEvents
+                    ? yield config.streamToEvents(new Response(guarded.stream, { headers: upstreamResponse.headers }), context)
+                    : yield createEventStream(new Response(guarded.stream, { headers: upstreamResponse.headers }), messageId), {
+                    headers: streamingHeaders,
+                });
+                yield ((_u = (_t = config.hooks) === null || _t === void 0 ? void 0 : _t.afterCall) === null || _u === void 0 ? void 0 : _u.call(_t, context, {
+                    status: 'streaming',
+                    upstreamStatusCode: upstreamResponse.status,
+                }));
+                return wrappedResponse;
+            }
+            catch (error$1) {
+                const normalized = error.normalizeAIError(error$1);
+                yield ((_w = (_v = config.hooks) === null || _v === void 0 ? void 0 : _v.onError) === null || _w === void 0 ? void 0 : _w.call(_v, context, normalized));
+                yield ((_z = (_y = (_x = config.adapters) === null || _x === void 0 ? void 0 : _x.billing) === null || _y === void 0 ? void 0 : _y.settle) === null || _z === void 0 ? void 0 : _z.call(_y, context, {
+                    status: normalized.status,
+                    upstreamStatusCode: normalized.upstreamStatusCode,
+                }));
+                return Response.json(normalized, {
+                    status: (_0 = normalized.upstreamStatusCode) !== null && _0 !== void 0 ? _0 : 500,
+                });
+            }
+        });
+    };
+}
+
+exports.createOpenRouterRoute = createOpenRouterRoute;
+exports.dynamic = dynamic;
+exports.revalidate = revalidate;
+exports.runtime = runtime;

package/dist/services/ai/route.mjs

@@ -0,0 +1,173 @@
+import { __awaiter } from 'tslib';
+import { AIRuntimeRequestSchema, createAIErrorPayload } from '@windrun-huaiin/contracts/ai';
+import { createUpstreamAbortSignal } from './abort.mjs';
+import { createOpenRouterClientConfigFromEnv, createOpenRouterMockFromEnvForContext } from './env.mjs';
+import { normalizeAIError } from './error.mjs';
+import { buildModelMessages } from './message-builder.mjs';
+import { callOpenRouterStream, guardedOpenRouterStreamStart } from './openrouter-client.mjs';
+
+const runtime = 'edge';
+const dynamic = 'force-dynamic';
+const revalidate = 0;
+const streamingHeaders = {
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate, no-transform',
+    Connection: 'keep-alive',
+    Pragma: 'no-cache',
+    'X-Accel-Buffering': 'no',
+};
+function createRequestId() {
+    try {
+        return crypto.randomUUID();
+    }
+    catch (_a) {
+        return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    }
+}
+function encodeEvent(event) {
+    return `data: ${JSON.stringify(event)}\n\n`;
+}
+function createEventStream(response, messageId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const encoder = new TextEncoder();
+        const decoder = new TextDecoder();
+        const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+        if (!reader) {
+            throw new Error('Missing upstream reader');
+        }
+        return new ReadableStream({
+            start(controller) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    controller.enqueue(encoder.encode(encodeEvent({
+                        type: 'message_started',
+                        messageId,
+                        createdAt: Date.now(),
+                    })));
+                    try {
+                        for (;;) {
+                            const chunk = yield reader.read();
+                            if (chunk.done) {
+                                break;
+                            }
+                            const text = decoder.decode(chunk.value, { stream: true });
+                            if (!text) {
+                                continue;
+                            }
+                            controller.enqueue(encoder.encode(encodeEvent({
+                                type: 'text_delta',
+                                messageId,
+                                text,
+                            })));
+                        }
+                        controller.enqueue(encoder.encode(encodeEvent({
+                            type: 'message_completed',
+                            messageId,
+                            createdAt: Date.now(),
+                        })));
+                        controller.close();
+                    }
+                    catch (error) {
+                        controller.enqueue(encoder.encode(encodeEvent({
+                            type: 'error',
+                            error: normalizeAIError(error),
+                        })));
+                        controller.close();
+                    }
+                });
+            },
+            cancel(reason) {
+                void reader.cancel(reason);
+            },
+        });
+    });
+}
+function createOpenRouterRoute(config) {
+    const openRouterConfig = createOpenRouterClientConfigFromEnv(config.openRouter);
+    return function POST(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+            const parsedBody = AIRuntimeRequestSchema.safeParse(yield request.json());
+            if (!parsedBody.success) {
+                const payload = createAIErrorPayload({
+                    message: 'Invalid AI runtime request body',
+                    upstreamStatusCode: 400,
+                    failureReason: 'invalid_request',
+                });
+                return Response.json(payload, { status: 400 });
+            }
+            const requestId = createRequestId();
+            const sessionId = (_a = parsedBody.data.sessionId) !== null && _a !== void 0 ? _a : ((_c = (_b = config.createSessionId) === null || _b === void 0 ? void 0 : _b.call(config)) !== null && _c !== void 0 ? _c : createRequestId());
+            const context = {
+                request,
+                input: parsedBody.data,
+                sessionId,
+                requestId,
+                startedAt: Date.now(),
+                metadata: parsedBody.data.metadata,
+            };
+            const mockHandler = (_d = config.mock) !== null && _d !== void 0 ? _d : createOpenRouterMockFromEnvForContext(context);
+            try {
+                yield ((_g = (_f = (_e = config.adapters) === null || _e === void 0 ? void 0 : _e.billing) === null || _f === void 0 ? void 0 : _f.reserve) === null || _g === void 0 ? void 0 : _g.call(_f, context));
+                yield ((_j = (_h = config.hooks) === null || _h === void 0 ? void 0 : _h.beforeCall) === null || _j === void 0 ? void 0 : _j.call(_h, context));
+                if (mockHandler) {
+                    const mockResponse = yield mockHandler(context);
+                    if (mockResponse) {
+                        return mockResponse;
+                    }
+                }
+                const runUpstream = () => __awaiter(this, void 0, void 0, function* () {
+                    var _a, _b, _c, _d;
+                    const upstreamSignal = createUpstreamAbortSignal(request.signal, (_b = (_a = config.timeoutMs) !== null && _a !== void 0 ? _a : openRouterConfig.timeoutMs) !== null && _b !== void 0 ? _b : 60000);
+                    const response = yield callOpenRouterStream(openRouterConfig, {
+                        model: (_c = parsedBody.data.modelName) !== null && _c !== void 0 ? _c : openRouterConfig.defaultModel,
+                        messages: ((_d = config.buildModelMessages) !== null && _d !== void 0 ? _d : buildModelMessages)(parsedBody.data.messages),
+                        stream: true,
+                        provider: openRouterConfig.provider,
+                        temperature: openRouterConfig.temperature,
+                        max_tokens: openRouterConfig.maxTokens,
+                    }, upstreamSignal);
+                    return response.response;
+                });
+                const upstreamResponse = ((_l = (_k = config.adapters) === null || _k === void 0 ? void 0 : _k.lock) === null || _l === void 0 ? void 0 : _l.withLock)
+                    ? yield config.adapters.lock.withLock(`ai:${sessionId}`, runUpstream)
+                    : yield runUpstream();
+                const guarded = yield guardedOpenRouterStreamStart(upstreamResponse);
+                if (!guarded.ok) {
+                    yield ((_o = (_m = config.hooks) === null || _m === void 0 ? void 0 : _m.onError) === null || _o === void 0 ? void 0 : _o.call(_m, context, guarded.error));
+                    yield ((_r = (_q = (_p = config.adapters) === null || _p === void 0 ? void 0 : _p.billing) === null || _q === void 0 ? void 0 : _q.settle) === null || _r === void 0 ? void 0 : _r.call(_q, context, {
+                        status: guarded.error.status,
+                        upstreamStatusCode: guarded.error.upstreamStatusCode,
+                    }));
+                    return Response.json(guarded.error, {
+                        status: (_s = guarded.error.upstreamStatusCode) !== null && _s !== void 0 ? _s : 500,
+                    });
+                }
+                const messageId = `asst-${requestId}`;
+                const wrappedResponse = new Response(config.streamToEvents
+                    ? yield config.streamToEvents(new Response(guarded.stream, { headers: upstreamResponse.headers }), context)
+                    : yield createEventStream(new Response(guarded.stream, { headers: upstreamResponse.headers }), messageId), {
+                    headers: streamingHeaders,
+                });
+                yield ((_u = (_t = config.hooks) === null || _t === void 0 ? void 0 : _t.afterCall) === null || _u === void 0 ? void 0 : _u.call(_t, context, {
+                    status: 'streaming',
+                    upstreamStatusCode: upstreamResponse.status,
+                }));
+                return wrappedResponse;
+            }
+            catch (error) {
+                const normalized = normalizeAIError(error);
+                yield ((_w = (_v = config.hooks) === null || _v === void 0 ? void 0 : _v.onError) === null || _w === void 0 ? void 0 : _w.call(_v, context, normalized));
+                yield ((_z = (_y = (_x = config.adapters) === null || _x === void 0 ? void 0 : _x.billing) === null || _y === void 0 ? void 0 : _y.settle) === null || _z === void 0 ? void 0 : _z.call(_y, context, {
+                    status: normalized.status,
+                    upstreamStatusCode: normalized.upstreamStatusCode,
+                }));
+                return Response.json(normalized, {
+                    status: (_0 = normalized.upstreamStatusCode) !== null && _0 !== void 0 ? _0 : 500,
+                });
+            }
+        });
+    };
+}
+
+export { createOpenRouterRoute, dynamic, revalidate, runtime };

package/dist/services/ai/types.d.ts

@@ -0,0 +1,98 @@
+import type { AIErrorPayload, AIMessageStatus, AIRuntimeRequest, AIStreamEvent, ConversationMessage } from '@windrun-huaiin/contracts/ai';
+export type AIRuntimeContext = {
+    request: Request;
+    input: AIRuntimeRequest;
+    sessionId: string;
+    requestId: string;
+    startedAt: number;
+    metadata?: Record<string, unknown>;
+};
+export type AIRuntimeUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+};
+export type AIRuntimeResult = {
+    status: AIMessageStatus;
+    message?: ConversationMessage;
+    usage?: AIRuntimeUsage;
+    upstreamStatusCode?: number;
+};
+export type AIBeforeCallHook = (context: AIRuntimeContext) => Promise<void> | void;
+export type AIAfterCallHook = (context: AIRuntimeContext, result: AIRuntimeResult) => Promise<void> | void;
+export type AIErrorHook = (context: AIRuntimeContext, error: AIErrorPayload) => Promise<void> | void;
+export type AIStorageAdapter = {
+    loadHistory?(input: {
+        sessionId: string;
+        userId?: string;
+    }): Promise<ConversationMessage[]>;
+    saveMessages?(input: {
+        sessionId: string;
+        userId?: string;
+        messages: ConversationMessage[];
+    }): Promise<void>;
+};
+export type AIBillingAdapter = {
+    reserve?(context: AIRuntimeContext): Promise<void>;
+    settle?(context: AIRuntimeContext, result: AIRuntimeResult): Promise<void>;
+};
+export type AILockAdapter = {
+    withLock?<T>(key: string, fn: () => Promise<T>): Promise<T>;
+};
+export type AIMockHandler = (context: AIRuntimeContext) => Promise<Response | null> | Response | null;
+export type AIRuntimeHooks = {
+    beforeCall?: AIBeforeCallHook;
+    afterCall?: AIAfterCallHook;
+    onError?: AIErrorHook;
+};
+export type AIRuntimeAdapters = {
+    storage?: AIStorageAdapter;
+    billing?: AIBillingAdapter;
+    lock?: AILockAdapter;
+};
+export type OpenRouterRequestBody = {
+    model: string;
+    messages: Array<{
+        role: 'user' | 'assistant' | 'system' | 'tool';
+        content: string;
+    }>;
+    stream: true;
+    provider?: Record<string, unknown>;
+    temperature?: number;
+    max_tokens?: number;
+};
+export type OpenRouterClientConfig = {
+    apiKey: string;
+    baseUrl?: string;
+    defaultModel: string;
+    referer?: string;
+    title?: string;
+    timeoutMs?: number;
+    provider?: Record<string, unknown>;
+    temperature?: number;
+    maxTokens?: number;
+    fetchImpl?: typeof fetch;
+};
+export type OpenRouterStreamResult = {
+    response: Response;
+    status: number;
+};
+export type AIRouteConfig = {
+    openRouter?: Partial<OpenRouterClientConfig>;
+    timeoutMs?: number;
+    createSessionId?: () => string;
+    mock?: AIMockHandler;
+    hooks?: AIRuntimeHooks;
+    adapters?: AIRuntimeAdapters;
+    buildModelMessages?: (messages: AIRuntimeRequest['messages']) => OpenRouterRequestBody['messages'];
+    streamToEvents?: (response: Response, context: AIRuntimeContext) => Promise<ReadableStream<Uint8Array>>;
+};
+export type GuardedStreamStartResult = {
+    ok: true;
+    stream: ReadableStream<Uint8Array>;
+} | {
+    ok: false;
+    error: AIErrorPayload;
+};
+export type EncodedAIStreamEvent = AIStreamEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/ai/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/backend-core",
-  "version": "15.1.0",
+  "version": "16.0.0",
   "description": "Shared backend primitives: Prisma schema/client, database services, routing helpers",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,6 +37,11 @@
       "import": "./dist/services/stripe/index.mjs",
       "require": "./dist/services/stripe/index.js"
     },
+    "./ai": {
+      "types": "./dist/services/ai/index.d.ts",
+      "import": "./dist/services/ai/index.mjs",
+      "require": "./dist/services/ai/index.js"
+    },
     "./lib": {
       "types": "./dist/lib/index.d.ts",
       "import": "./dist/lib/index.mjs",
@@ -107,8 +112,9 @@
     "svix": "^1.86.0",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@windrun-huaiin/lib": "^15.1.0",
-    "@windrun-huaiin/third-ui": "^15.1.0"
+    "@windrun-huaiin/contracts": "^1.0.0",
+    "@windrun-huaiin/lib": "^16.0.0",
+    "@windrun-huaiin/third-ui": "^16.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "^5.1.1",
@@ -125,7 +131,8 @@
     "next": "16.1.6",
     "prisma": "^6.19.0",
     "stripe": "20.0.0",
-    "svix": "^1.86.0"
+    "svix": "^1.86.0",
+    "@windrun-huaiin/contracts": "^1.0.0"
   },
   "publishConfig": {
     "access": "public"