@windrun-huaiin/backend-core 15.1.0 → 16.0.0

package/dist/lib/upstash-config.mjs

@@ -17,6 +17,7 @@ let qstashWarnedHealthCheck = false;
 let qstashWarnedHealthSchedule = false;
 let redisHealthTimer = null;
 let qstashHealthTimer = null;
+let cachedRedisPrefixed = null;
 const isNonEmpty = (value) => typeof value === 'string' && value.trim().length > 0;
 const isValidUrl = (value) => {
     try {
@@ -27,6 +28,75 @@ const isValidUrl = (value) => {
         return false;
     }
 };
+const getRequiredRedisAppName = () => {
+    const appName = process.env.NEXT_PUBLIC_APP_NAME;
+    if (!isNonEmpty(appName)) {
+        throw new Error('[Upstash Config] NEXT_PUBLIC_APP_NAME is required for Redis key prefixing and must not be empty');
+    }
+    const normalized = appName.replace(/\s+/g, '').toLowerCase();
+    if (!normalized) {
+        throw new Error('[Upstash Config] NEXT_PUBLIC_APP_NAME must contain non-whitespace characters for Redis key prefixing');
+    }
+    return normalized;
+};
+const getRedisKeyPrefix = () => {
+    const envSuffix = process.env.NODE_ENV === 'production' ? 'live' : 'test';
+    return `${getRequiredRedisAppName()}_${envSuffix}`;
+};
+const prefixRedisKey = (prefix, key) => `${prefix}:${key}`;
+const prefixRedisKeys = (prefix, keys) => keys.map((key) => prefixRedisKey(prefix, key));
+const prefixFirstStringArg = (args, prefix) => {
+    if (typeof args[0] !== 'string') {
+        return args;
+    }
+    const nextArgs = [...args];
+    nextArgs[0] = prefixRedisKey(prefix, args[0]);
+    return nextArgs;
+};
+const prefixAllStringArgs = (args, prefix) => {
+    return args.map((arg) => (typeof arg === 'string' ? prefixRedisKey(prefix, arg) : arg));
+};
+const keyArrayCommands = new Set(['mget', 'del']);
+const allStringKeyCommands = new Set(['exists']);
+const createPrefixedPipeline = (target, prefix) => {
+    return new Proxy(target, {
+        get(obj, prop, receiver) {
+            const value = Reflect.get(obj, prop, receiver);
+            if (typeof value !== 'function') {
+                return value;
+            }
+            return (...args) => {
+                if (prop === 'eval' || prop === 'evalsha' || prop === 'evalro' || prop === 'evalshaRo') {
+                    const [script, keys, argv] = args;
+                    return value.call(obj, script, prefixRedisKeys(prefix, keys), argv);
+                }
+                if (prop === 'pipeline' || prop === 'multi') {
+                    const nested = value.call(obj);
+                    return createPrefixedPipeline(nested, prefix);
+                }
+                if (typeof prop === 'string' && keyArrayCommands.has(prop)) {
+                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    return value.apply(obj, nextArgs);
+                }
+                if (typeof prop === 'string' && allStringKeyCommands.has(prop)) {
+                    const nextArgs = prefixAllStringArgs(args, prefix);
+                    return value.apply(obj, nextArgs);
+                }
+                if (prop === 'mset') {
+                    const [entries] = args;
+                    const prefixedEntries = Object.fromEntries(Object.entries(entries).map(([key, entryValue]) => [prefixRedisKey(prefix, key), entryValue]));
+                    return value.call(obj, prefixedEntries);
+                }
+                if (prop === 'hmget') {
+                    const nextArgs = prefixFirstStringArg(args, prefix);
+                    return value.apply(obj, nextArgs);
+                }
+                const nextArgs = prefixFirstStringArg(args, prefix);
+                return value.apply(obj, nextArgs);
+            };
+        },
+    });
+};
 const parseMinutes = (value, fallback) => {
     if (!isNonEmpty(value)) {
         return fallback;
@@ -129,11 +199,11 @@ const scheduleQstashHealthCheck = (token) => {
  * - read-through cached instance only
  */
 const getRedis = () => {
-    return cachedRedis;
+    return cachedRedisPrefixed;
 };
 const ensureRedis = () => __awaiter(void 0, void 0, void 0, function* () {
-    if (cachedRedis) {
-        return cachedRedis;
+    if (cachedRedisPrefixed) {
+        return cachedRedisPrefixed;
     }
     if (redisInitPromise) {
         return redisInitPromise;
@@ -155,14 +225,16 @@ const ensureRedis = () => __awaiter(void 0, void 0, void 0, function* () {
             return null;
         }
         try {
+            const keyPrefix = getRedisKeyPrefix();
             const client = new Redis({
                 url: UPSTASH_REDIS_REST_URL,
                 token: UPSTASH_REDIS_REST_TOKEN,
             });
             yield client.ping();
             cachedRedis = client;
+            cachedRedisPrefixed = createPrefixedPipeline(client, keyPrefix);
             scheduleRedisHealthCheck();
-            return cachedRedis;
+            return cachedRedisPrefixed;
         }
         catch (error) {
             if (!redisWarnedInitError) {

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

@@ -0,0 +1,2 @@
+export declare function createUpstreamAbortSignal(requestSignal: AbortSignal, timeoutMs: number): AbortSignal;
+//# sourceMappingURL=abort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../../src/services/ai/abort.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAyBtF"}

package/dist/services/ai/abort.js

@@ -0,0 +1,24 @@
+'use strict';
+
+function createUpstreamAbortSignal(requestSignal, timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort('timeout'), timeoutMs);
+    const forwardAbort = () => {
+        var _a;
+        clearTimeout(timeoutId);
+        controller.abort((_a = requestSignal.reason) !== null && _a !== void 0 ? _a : 'request_aborted');
+    };
+    if (requestSignal.aborted) {
+        forwardAbort();
+    }
+    else {
+        requestSignal.addEventListener('abort', forwardAbort, { once: true });
+    }
+    controller.signal.addEventListener('abort', () => {
+        clearTimeout(timeoutId);
+        requestSignal.removeEventListener('abort', forwardAbort);
+    }, { once: true });
+    return controller.signal;
+}
+
+exports.createUpstreamAbortSignal = createUpstreamAbortSignal;

package/dist/services/ai/abort.mjs

@@ -0,0 +1,22 @@
+function createUpstreamAbortSignal(requestSignal, timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort('timeout'), timeoutMs);
+    const forwardAbort = () => {
+        var _a;
+        clearTimeout(timeoutId);
+        controller.abort((_a = requestSignal.reason) !== null && _a !== void 0 ? _a : 'request_aborted');
+    };
+    if (requestSignal.aborted) {
+        forwardAbort();
+    }
+    else {
+        requestSignal.addEventListener('abort', forwardAbort, { once: true });
+    }
+    controller.signal.addEventListener('abort', () => {
+        clearTimeout(timeoutId);
+        requestSignal.removeEventListener('abort', forwardAbort);
+    }, { once: true });
+    return controller.signal;
+}
+
+export { createUpstreamAbortSignal };

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

@@ -0,0 +1,21 @@
+import type { AIMockHandler, AIRuntimeContext, OpenRouterClientConfig } from './types';
+export type OpenRouterEnvConfig = {
+    appName: string;
+    timeoutMs: number;
+    apiKey: string;
+    modelName: string;
+    enableMock: boolean;
+    mockType: number;
+    mockTimeoutSeconds: number;
+    mockStreamChunkDelayMs: number;
+    mockStreamChunkSize: number;
+    contextWindowTurns: number;
+    debug: boolean;
+    baseUrl?: string;
+    referer?: string;
+};
+export declare function getOpenRouterEnvConfig(): OpenRouterEnvConfig;
+export declare function createOpenRouterClientConfigFromEnv(overrides?: Partial<OpenRouterClientConfig>): OpenRouterClientConfig;
+export declare function createOpenRouterMockFromEnv(): AIMockHandler | undefined;
+export declare function createOpenRouterMockFromEnvForContext(context?: AIRuntimeContext): AIMockHandler | undefined;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/services/ai/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAgBvF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAUF,wBAAgB,sBAAsB,IAAI,mBAAmB,CAiB5D;AAED,wBAAgB,mCAAmC,CACjD,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,sBAAsB,CAexB;AAED,wBAAgB,2BAA2B,IAAI,aAAa,GAAG,SAAS,CAEvE;AAWD,wBAAgB,qCAAqC,CACnD,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,GAAG,SAAS,CA0B3B"}

package/dist/services/ai/env.js

@@ -0,0 +1,85 @@
+'use strict';
+
+var mock = require('./mock.js');
+
+function parseNumber(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parseBoolean(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    return value === '1' || value === 'true' || value === 'TRUE';
+}
+function getOpenRouterEnvConfig() {
+    return {
+        appName: process.env.NEXT_PUBLIC_APP_NAME || 'DDaaS',
+        timeoutMs: parseNumber(process.env.OPENROUTER_TIMEOUT_SECONDS, 240) * 1000,
+        apiKey: process.env.OPENROUTER_API_KEY || '',
+        modelName: process.env.NEXT_PUBLIC_OPENROUTER_MODEL_NAME || 'google/gemini-2.0-flash-001',
+        enableMock: parseBoolean(process.env.OPENROUTER_ENABLE_MOCK, true),
+        mockType: parseNumber(process.env.OPENROUTER_MOCK_TYPE, 0),
+        mockTimeoutSeconds: parseNumber(process.env.OPENROUTER_MOCK_TIMEOUT_SECONDS, 3),
+        mockStreamChunkDelayMs: parseNumber(process.env.OPENROUTER_MOCK_STREAM_CHUNK_DELAY_MS, 60),
+        mockStreamChunkSize: parseNumber(process.env.OPENROUTER_MOCK_STREAM_CHUNK_SIZE, 8),
+        contextWindowTurns: parseNumber(process.env.NEXT_PUBLIC_CHAT_CONTEXT_WINDOW_TURNS, 6),
+        debug: parseBoolean(process.env.NEXT_PUBLIC_OPENROUTER_DEBUG, false),
+        baseUrl: process.env.OPENROUTER_BASE_URL,
+        referer: process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000',
+    };
+}
+function createOpenRouterClientConfigFromEnv(overrides) {
+    var _a, _b, _c, _d, _e, _f;
+    const envConfig = getOpenRouterEnvConfig();
+    return {
+        apiKey: (_a = overrides === null || overrides === void 0 ? void 0 : overrides.apiKey) !== null && _a !== void 0 ? _a : envConfig.apiKey,
+        baseUrl: (_b = overrides === null || overrides === void 0 ? void 0 : overrides.baseUrl) !== null && _b !== void 0 ? _b : envConfig.baseUrl,
+        defaultModel: (_c = overrides === null || overrides === void 0 ? void 0 : overrides.defaultModel) !== null && _c !== void 0 ? _c : envConfig.modelName,
+        referer: (_d = overrides === null || overrides === void 0 ? void 0 : overrides.referer) !== null && _d !== void 0 ? _d : envConfig.referer,
+        title: (_e = overrides === null || overrides === void 0 ? void 0 : overrides.title) !== null && _e !== void 0 ? _e : envConfig.appName,
+        timeoutMs: (_f = overrides === null || overrides === void 0 ? void 0 : overrides.timeoutMs) !== null && _f !== void 0 ? _f : envConfig.timeoutMs,
+        provider: overrides === null || overrides === void 0 ? void 0 : overrides.provider,
+        temperature: overrides === null || overrides === void 0 ? void 0 : overrides.temperature,
+        maxTokens: overrides === null || overrides === void 0 ? void 0 : overrides.maxTokens,
+        fetchImpl: overrides === null || overrides === void 0 ? void 0 : overrides.fetchImpl,
+    };
+}
+function createOpenRouterMockFromEnv() {
+    return createOpenRouterMockFromEnvForContext();
+}
+function getRequestMockOverride(context) {
+    var _a;
+    const value = (_a = context === null || context === void 0 ? void 0 : context.input.metadata) === null || _a === void 0 ? void 0 : _a.mock;
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+function createOpenRouterMockFromEnvForContext(context) {
+    var _a, _b, _c, _d;
+    const envConfig = getOpenRouterEnvConfig();
+    if (!envConfig.enableMock) {
+        return undefined;
+    }
+    const requestOverride = getRequestMockOverride(context);
+    if ((requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.enabled) === false) {
+        return undefined;
+    }
+    const mockType = (_a = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.type) !== null && _a !== void 0 ? _a : envConfig.mockType;
+    const mockTimeoutSeconds = (_b = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.timeoutSeconds) !== null && _b !== void 0 ? _b : envConfig.mockTimeoutSeconds;
+    const mockStreamChunkDelayMs = (_c = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.chunkDelayMs) !== null && _c !== void 0 ? _c : envConfig.mockStreamChunkDelayMs;
+    const mockStreamChunkSize = (_d = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.chunkSize) !== null && _d !== void 0 ? _d : envConfig.mockStreamChunkSize;
+    return mock.createScenarioMockHandler({
+        text: 'This is a mock AI response from the shared backend-core runtime. Configure OPENROUTER_API_KEY and disable OPENROUTER_ENABLE_MOCK to use the real upstream model.',
+        mockType,
+        mockTimeoutSeconds,
+        mockStreamChunkDelayMs,
+        mockStreamChunkSize,
+    });
+}
+
+exports.createOpenRouterClientConfigFromEnv = createOpenRouterClientConfigFromEnv;
+exports.createOpenRouterMockFromEnv = createOpenRouterMockFromEnv;
+exports.createOpenRouterMockFromEnvForContext = createOpenRouterMockFromEnvForContext;
+exports.getOpenRouterEnvConfig = getOpenRouterEnvConfig;

package/dist/services/ai/env.mjs

@@ -0,0 +1,80 @@
+import { createScenarioMockHandler } from './mock.mjs';
+
+function parseNumber(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function parseBoolean(value, fallback) {
+    if (value === undefined) {
+        return fallback;
+    }
+    return value === '1' || value === 'true' || value === 'TRUE';
+}
+function getOpenRouterEnvConfig() {
+    return {
+        appName: process.env.NEXT_PUBLIC_APP_NAME || 'DDaaS',
+        timeoutMs: parseNumber(process.env.OPENROUTER_TIMEOUT_SECONDS, 240) * 1000,
+        apiKey: process.env.OPENROUTER_API_KEY || '',
+        modelName: process.env.NEXT_PUBLIC_OPENROUTER_MODEL_NAME || 'google/gemini-2.0-flash-001',
+        enableMock: parseBoolean(process.env.OPENROUTER_ENABLE_MOCK, true),
+        mockType: parseNumber(process.env.OPENROUTER_MOCK_TYPE, 0),
+        mockTimeoutSeconds: parseNumber(process.env.OPENROUTER_MOCK_TIMEOUT_SECONDS, 3),
+        mockStreamChunkDelayMs: parseNumber(process.env.OPENROUTER_MOCK_STREAM_CHUNK_DELAY_MS, 60),
+        mockStreamChunkSize: parseNumber(process.env.OPENROUTER_MOCK_STREAM_CHUNK_SIZE, 8),
+        contextWindowTurns: parseNumber(process.env.NEXT_PUBLIC_CHAT_CONTEXT_WINDOW_TURNS, 6),
+        debug: parseBoolean(process.env.NEXT_PUBLIC_OPENROUTER_DEBUG, false),
+        baseUrl: process.env.OPENROUTER_BASE_URL,
+        referer: process.env.NEXT_PUBLIC_BASE_URL || 'http://localhost:3000',
+    };
+}
+function createOpenRouterClientConfigFromEnv(overrides) {
+    var _a, _b, _c, _d, _e, _f;
+    const envConfig = getOpenRouterEnvConfig();
+    return {
+        apiKey: (_a = overrides === null || overrides === void 0 ? void 0 : overrides.apiKey) !== null && _a !== void 0 ? _a : envConfig.apiKey,
+        baseUrl: (_b = overrides === null || overrides === void 0 ? void 0 : overrides.baseUrl) !== null && _b !== void 0 ? _b : envConfig.baseUrl,
+        defaultModel: (_c = overrides === null || overrides === void 0 ? void 0 : overrides.defaultModel) !== null && _c !== void 0 ? _c : envConfig.modelName,
+        referer: (_d = overrides === null || overrides === void 0 ? void 0 : overrides.referer) !== null && _d !== void 0 ? _d : envConfig.referer,
+        title: (_e = overrides === null || overrides === void 0 ? void 0 : overrides.title) !== null && _e !== void 0 ? _e : envConfig.appName,
+        timeoutMs: (_f = overrides === null || overrides === void 0 ? void 0 : overrides.timeoutMs) !== null && _f !== void 0 ? _f : envConfig.timeoutMs,
+        provider: overrides === null || overrides === void 0 ? void 0 : overrides.provider,
+        temperature: overrides === null || overrides === void 0 ? void 0 : overrides.temperature,
+        maxTokens: overrides === null || overrides === void 0 ? void 0 : overrides.maxTokens,
+        fetchImpl: overrides === null || overrides === void 0 ? void 0 : overrides.fetchImpl,
+    };
+}
+function createOpenRouterMockFromEnv() {
+    return createOpenRouterMockFromEnvForContext();
+}
+function getRequestMockOverride(context) {
+    var _a;
+    const value = (_a = context === null || context === void 0 ? void 0 : context.input.metadata) === null || _a === void 0 ? void 0 : _a.mock;
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+function createOpenRouterMockFromEnvForContext(context) {
+    var _a, _b, _c, _d;
+    const envConfig = getOpenRouterEnvConfig();
+    if (!envConfig.enableMock) {
+        return undefined;
+    }
+    const requestOverride = getRequestMockOverride(context);
+    if ((requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.enabled) === false) {
+        return undefined;
+    }
+    const mockType = (_a = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.type) !== null && _a !== void 0 ? _a : envConfig.mockType;
+    const mockTimeoutSeconds = (_b = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.timeoutSeconds) !== null && _b !== void 0 ? _b : envConfig.mockTimeoutSeconds;
+    const mockStreamChunkDelayMs = (_c = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.chunkDelayMs) !== null && _c !== void 0 ? _c : envConfig.mockStreamChunkDelayMs;
+    const mockStreamChunkSize = (_d = requestOverride === null || requestOverride === void 0 ? void 0 : requestOverride.chunkSize) !== null && _d !== void 0 ? _d : envConfig.mockStreamChunkSize;
+    return createScenarioMockHandler({
+        text: 'This is a mock AI response from the shared backend-core runtime. Configure OPENROUTER_API_KEY and disable OPENROUTER_ENABLE_MOCK to use the real upstream model.',
+        mockType,
+        mockTimeoutSeconds,
+        mockStreamChunkDelayMs,
+        mockStreamChunkSize,
+    });
+}
+
+export { createOpenRouterClientConfigFromEnv, createOpenRouterMockFromEnv, createOpenRouterMockFromEnvForContext, getOpenRouterEnvConfig };

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

@@ -0,0 +1,3 @@
+import { type AIErrorPayload } from '@windrun-huaiin/contracts/ai';
+export declare function normalizeAIError(error: unknown): AIErrorPayload;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/services/ai/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AA2BtC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiC/D"}

package/dist/services/ai/error.js

@@ -0,0 +1,54 @@
+'use strict';
+
+var ai = require('@windrun-huaiin/contracts/ai');
+
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function getProviderErrorMessage(data) {
+    if (!isObject(data)) {
+        return null;
+    }
+    const error = data.error;
+    if (isObject(error) && typeof error.message === 'string') {
+        return error.message;
+    }
+    if (typeof data.message === 'string') {
+        return data.message;
+    }
+    return null;
+}
+function isAbortError(error) {
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+function normalizeAIError(error) {
+    var _a;
+    if (isObject(error) && typeof error.status === 'number') {
+        const message = (_a = getProviderErrorMessage(error)) !== null && _a !== void 0 ? _a : (typeof error.message === 'string' ? error.message : 'Error communicating with AI');
+        return ai.createAIErrorPayload({
+            message,
+            upstreamStatusCode: error.status,
+        });
+    }
+    if (error instanceof Response) {
+        return ai.createAIErrorPayload({
+            message: error.statusText || 'Error communicating with AI',
+            upstreamStatusCode: error.status || 500,
+        });
+    }
+    if (isAbortError(error)) {
+        return {
+            error: 'Request timed out',
+            status: 'timeout',
+            upstreamStatusCode: 408,
+        };
+    }
+    return {
+        error: error instanceof Error ? error.message : 'Error communicating with AI',
+        status: 'failed',
+        failureReason: 'unknown',
+        upstreamStatusCode: 500,
+    };
+}
+
+exports.normalizeAIError = normalizeAIError;

package/dist/services/ai/error.mjs

@@ -0,0 +1,52 @@
+import { createAIErrorPayload } from '@windrun-huaiin/contracts/ai';
+
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function getProviderErrorMessage(data) {
+    if (!isObject(data)) {
+        return null;
+    }
+    const error = data.error;
+    if (isObject(error) && typeof error.message === 'string') {
+        return error.message;
+    }
+    if (typeof data.message === 'string') {
+        return data.message;
+    }
+    return null;
+}
+function isAbortError(error) {
+    return error instanceof DOMException && error.name === 'AbortError';
+}
+function normalizeAIError(error) {
+    var _a;
+    if (isObject(error) && typeof error.status === 'number') {
+        const message = (_a = getProviderErrorMessage(error)) !== null && _a !== void 0 ? _a : (typeof error.message === 'string' ? error.message : 'Error communicating with AI');
+        return createAIErrorPayload({
+            message,
+            upstreamStatusCode: error.status,
+        });
+    }
+    if (error instanceof Response) {
+        return createAIErrorPayload({
+            message: error.statusText || 'Error communicating with AI',
+            upstreamStatusCode: error.status || 500,
+        });
+    }
+    if (isAbortError(error)) {
+        return {
+            error: 'Request timed out',
+            status: 'timeout',
+            upstreamStatusCode: 408,
+        };
+    }
+    return {
+        error: error instanceof Error ? error.message : 'Error communicating with AI',
+        status: 'failed',
+        failureReason: 'unknown',
+        upstreamStatusCode: 500,
+    };
+}
+
+export { normalizeAIError };

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

@@ -0,0 +1,9 @@
+export * from './types';
+export * from './abort';
+export * from './error';
+export * from './env';
+export * from './message-builder';
+export * from './mock';
+export * from './openrouter-client';
+export * from './route';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/services/ai/index.js

@@ -0,0 +1,30 @@
+'use strict';
+
+var abort = require('./abort.js');
+var error = require('./error.js');
+var env = require('./env.js');
+var messageBuilder = require('./message-builder.js');
+var mock = require('./mock.js');
+var openrouterClient = require('./openrouter-client.js');
+var route = require('./route.js');
+
+
+
+exports.createUpstreamAbortSignal = abort.createUpstreamAbortSignal;
+exports.normalizeAIError = error.normalizeAIError;
+exports.createOpenRouterClientConfigFromEnv = env.createOpenRouterClientConfigFromEnv;
+exports.createOpenRouterMockFromEnv = env.createOpenRouterMockFromEnv;
+exports.createOpenRouterMockFromEnvForContext = env.createOpenRouterMockFromEnvForContext;
+exports.getOpenRouterEnvConfig = env.getOpenRouterEnvConfig;
+exports.buildModelMessages = messageBuilder.buildModelMessages;
+exports.createConfigurableMockHandler = mock.createConfigurableMockHandler;
+exports.createErrorMockResponse = mock.createErrorMockResponse;
+exports.createScenarioMockHandler = mock.createScenarioMockHandler;
+exports.createSimpleMockHandler = mock.createSimpleMockHandler;
+exports.getMockScenario = mock.getMockScenario;
+exports.callOpenRouterStream = openrouterClient.callOpenRouterStream;
+exports.guardedOpenRouterStreamStart = openrouterClient.guardedOpenRouterStreamStart;
+exports.createOpenRouterRoute = route.createOpenRouterRoute;
+exports.dynamic = route.dynamic;
+exports.revalidate = route.revalidate;
+exports.runtime = route.runtime;

package/dist/services/ai/index.mjs

@@ -0,0 +1,7 @@
+export { createUpstreamAbortSignal } from './abort.mjs';
+export { normalizeAIError } from './error.mjs';
+export { createOpenRouterClientConfigFromEnv, createOpenRouterMockFromEnv, createOpenRouterMockFromEnvForContext, getOpenRouterEnvConfig } from './env.mjs';
+export { buildModelMessages } from './message-builder.mjs';
+export { createConfigurableMockHandler, createErrorMockResponse, createScenarioMockHandler, createSimpleMockHandler, getMockScenario } from './mock.mjs';
+export { callOpenRouterStream, guardedOpenRouterStreamStart } from './openrouter-client.mjs';
+export { createOpenRouterRoute, dynamic, revalidate, runtime } from './route.mjs';

package/dist/services/ai/message-builder.d.ts

@@ -0,0 +1,4 @@
+import { type AIRuntimeRequest } from '@windrun-huaiin/contracts/ai';
+import type { OpenRouterRequestBody } from './types';
+export declare function buildModelMessages(messages: AIRuntimeRequest['messages']): OpenRouterRequestBody['messages'];
+//# sourceMappingURL=message-builder.d.ts.map

package/dist/services/ai/message-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builder.d.ts","sourceRoot":"","sources":["../../../src/services/ai/message-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACrC,qBAAqB,CAAC,UAAU,CAAC,CAQnC"}

package/dist/services/ai/message-builder.js

@@ -0,0 +1,15 @@
+'use strict';
+
+var ai = require('@windrun-huaiin/contracts/ai');
+
+function buildModelMessages(messages) {
+    return messages
+        .filter((message) => message.status !== 'failed')
+        .map((message) => ({
+        role: message.role,
+        content: ai.getMessageText(message),
+    }))
+        .filter((message) => message.content.trim().length > 0);
+}
+
+exports.buildModelMessages = buildModelMessages;

package/dist/services/ai/message-builder.mjs

@@ -0,0 +1,13 @@
+import { getMessageText } from '@windrun-huaiin/contracts/ai';
+
+function buildModelMessages(messages) {
+    return messages
+        .filter((message) => message.status !== 'failed')
+        .map((message) => ({
+        role: message.role,
+        content: getMessageText(message),
+    }))
+        .filter((message) => message.content.trim().length > 0);
+}
+
+export { buildModelMessages };

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

@@ -0,0 +1,30 @@
+import type { AIMockHandler } from './types';
+export declare function createSimpleMockHandler(text: string): AIMockHandler;
+export declare function createErrorMockResponse(statusCode: number, message: string): Response;
+type MockFailureType = 'timeout' | 'request_aborted' | 'stream_error';
+type MockScenario = {
+    mode?: 'text_stream' | 'event_sequence';
+    initialDelayMs?: number;
+    streamFailureType?: MockFailureType;
+    streamFailureAfterChunks?: number;
+    immediateErrorType?: MockFailureType;
+};
+export type ConfigurableMockOptions = {
+    text: string;
+    initialDelayMs?: number;
+    chunkDelayMs?: number;
+    chunkSize?: number;
+    streamFailureType?: MockFailureType;
+    streamFailureAfterChunks?: number;
+};
+export declare function getMockScenario(mockType: number, mockTimeoutMs: number): MockScenario;
+export declare function createConfigurableMockHandler(options: ConfigurableMockOptions): AIMockHandler;
+export declare function createScenarioMockHandler(params: {
+    text: string;
+    mockType: number;
+    mockTimeoutSeconds: number;
+    mockStreamChunkDelayMs: number;
+    mockStreamChunkSize: number;
+}): AIMockHandler;
+export {};
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/services/ai/mock.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,SAAS,CAAC;AA8B/D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAqBnE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAQ1E;AAED,KAAK,eAAe,GAAG,SAAS,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAEtE,KAAK,YAAY,GAAG;IAClB,IAAI,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kBAAkB,CAAC,EAAE,eAAe,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CA2CrF;AA6CD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CA0E7F;AAiGD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,aAAa,CA0BhB"}