ysk-omni 1.0.0

package/dist/services/media/providers/media-provider.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+/** Pluggable media generation backends (media tools, HTTP providers, mock). */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=media-provider.interface.js.map

package/dist/services/media/providers/media-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-provider.interface.js","sourceRoot":"","sources":["../../../../src/services/media/providers/media-provider.interface.ts"],"names":[],"mappings":";AAAA,+EAA+E"}

package/dist/services/media/providers/mock.provider.d.ts

@@ -0,0 +1,8 @@
+import type { ImageEditRequest, ImageGenRequest, MediaArtifact, MediaProvider } from './media-provider.interface';
+export declare class MockMediaProvider implements MediaProvider {
+    readonly id = "mock";
+    generateImage(req: ImageGenRequest): Promise<MediaArtifact[]>;
+    editImage(req: ImageEditRequest): Promise<MediaArtifact[]>;
+}
+export declare const mockMediaProvider: MockMediaProvider;
+//# sourceMappingURL=mock.provider.d.ts.map

package/dist/services/media/providers/mock.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.provider.d.ts","sourceRoot":"","sources":["../../../../src/services/media/providers/mock.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAWpC,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,EAAE,UAAU;IAEf,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAe7D,SAAS,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAejE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/services/media/providers/mock.provider.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockMediaProvider = exports.MockMediaProvider = void 0;
+/**
+ * Deterministic 1×1 PNG for tests (no local engine).
+ * Enable with MEDIA_PROVIDER=mock or setMediaProviderForTests.
+ */
+const PNG_1X1 = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==', 'base64');
+class MockMediaProvider {
+    id = 'mock';
+    async generateImage(req) {
+        const n = Math.min(Math.max(req.n ?? 1, 1), 4);
+        return Array.from({ length: n }, (_, i) => ({
+            bytes: PNG_1X1,
+            mime: 'image/png',
+            originalName: `mock-${i + 1}.png`,
+            width: 1,
+            height: 1,
+            source: {
+                provider: 'mock',
+                rawMeta: { prompt: req.prompt, size: req.size },
+            },
+        }));
+    }
+    async editImage(req) {
+        const arts = await this.generateImage(req);
+        return arts.map((a, i) => ({
+            ...a,
+            originalName: `mock-edit-${i + 1}.png`,
+            source: {
+                provider: 'mock',
+                rawMeta: {
+                    prompt: req.prompt,
+                    edit: true,
+                    inputBytes: req.imageBytes.length,
+                },
+            },
+        }));
+    }
+}
+exports.MockMediaProvider = MockMediaProvider;
+exports.mockMediaProvider = new MockMediaProvider();
+//# sourceMappingURL=mock.provider.js.map

package/dist/services/media/providers/mock.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.provider.js","sourceRoot":"","sources":["../../../../src/services/media/providers/mock.provider.ts"],"names":[],"mappings":";;;AAOA;;;GAGG;AACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,kGAAkG,EAClG,QAAQ,CACT,CAAC;AAEF,MAAa,iBAAiB;IACnB,EAAE,GAAG,MAAM,CAAC;IAErB,KAAK,CAAC,aAAa,CAAC,GAAoB;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM;YACjC,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE;gBACN,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;aAChD;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAqB;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,CAAC;YACJ,YAAY,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM;YACtC,MAAM,EAAE;gBACN,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE;oBACP,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,IAAI,EAAE,IAAI;oBACV,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM;iBAClC;aACF;SACF,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAjCD,8CAiCC;AAEY,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/services/media/providers/stub.provider.d.ts

@@ -0,0 +1,8 @@
+import type { ImageGenRequest, MediaArtifact, MediaProvider } from './media-provider.interface';
+/** Feature off / no backend — always 501/503 via factory. */
+export declare class StubMediaProvider implements MediaProvider {
+    readonly id = "none";
+    generateImage(_req: ImageGenRequest): Promise<MediaArtifact[]>;
+}
+export declare const stubMediaProvider: StubMediaProvider;
+//# sourceMappingURL=stub.provider.d.ts.map

package/dist/services/media/providers/stub.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.provider.d.ts","sourceRoot":"","sources":["../../../../src/services/media/providers/stub.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,4BAA4B,CAAC;AAEpC,6DAA6D;AAC7D,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,EAAE,UAAU;IAEf,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAKrE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/services/media/providers/stub.provider.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stubMediaProvider = exports.StubMediaProvider = void 0;
+const exception_factory_1 = require("../../../exceptions/exception.factory");
+/** Feature off / no backend — always 501/503 via factory. */
+class StubMediaProvider {
+    id = 'none';
+    async generateImage(_req) {
+        throw exception_factory_1.ExceptionFactory.mediaProviderUnavailable('No media provider configured. Enable imagesApi and use an agent key, or set a media provider.');
+    }
+}
+exports.StubMediaProvider = StubMediaProvider;
+exports.stubMediaProvider = new StubMediaProvider();
+//# sourceMappingURL=stub.provider.js.map

package/dist/services/media/providers/stub.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.provider.js","sourceRoot":"","sources":["../../../../src/services/media/providers/stub.provider.ts"],"names":[],"mappings":";;;AAAA,6EAAyE;AAOzE,6DAA6D;AAC7D,MAAa,iBAAiB;IACnB,EAAE,GAAG,MAAM,CAAC;IAErB,KAAK,CAAC,aAAa,CAAC,IAAqB;QACvC,MAAM,oCAAgB,CAAC,wBAAwB,CAC7C,+FAA+F,CAChG,CAAC;IACJ,CAAC;CACF;AARD,8CAQC;AAEY,QAAA,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/services/media/video-fixture.d.ts

@@ -0,0 +1,3 @@
+/** H.264 MP4 minted with ffmpeg (32x32, 0.4s, comment=ysk-omni-video-fixture). */
+export declare const VIDEO_FIXTURE_B64: string;
+//# sourceMappingURL=video-fixture.d.ts.map

package/dist/services/media/video-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-fixture.d.ts","sourceRoot":"","sources":["../../../src/services/media/video-fixture.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAkCT,CAAC"}

package/dist/services/media/video-fixture.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIDEO_FIXTURE_B64 = void 0;
+/** H.264 MP4 minted with ffmpeg (32x32, 0.4s, comment=ysk-omni-video-fixture). */
+exports.VIDEO_FIXTURE_B64 = `
+AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAPebW9vdgAAAGxtdmhkAAAAAAAAAAAA
+AAAAAAAD6AAAAZAAAQAAAQAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAA
+AABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAAtt0cmFrAAAAXHRraGQAAAADAAAA
+AAAAAAAAAAABAAAAAAAAAZAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAA
+AAAAAAAAAABAAAAAACAAAAAgAAAAAAAkZWR0cwAAABxlbHN0AAAAAAAAAAEAAAGQAAAEAAABAAAA
+AAJTbWRpYQAAACBtZGhkAAAAAAAAAAAAAAAAAAAyAAAAFABVxAAAAAAALWhkbHIAAAAAAAAAAHZp
+ZGUAAAAAAAAAAAAAAABWaWRlb0hhbmRsZXIAAAAB/m1pbmYAAAAUdm1oZAAAAAEAAAAAAAAAAAAA
+ACRkaW5mAAAAHGRyZWYAAAAAAAAAAQAAAAx1cmwgAAAAAQAAAb5zdGJsAAAAvnN0c2QAAAAAAAAA
+AQAAAK5hdmMxAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAACAAIABIAAAASAAAAAAAAAABFExhdmM2
+My4xLjEwMiBsaWJ4MjY0AAAAAAAAAAAAAAAAGP//AAAANGF2Y0MBZAAK/+EAF2dkAAqs2UlsBEAA
+AAMAQAAADIPEiWWAAQAGaOvjyyLA/fj4AAAAABBwYXNwAAAAAQAAAAEAAAAUYnRydAAAAAAAAEGM
+AAAAAAAAABhzdHRzAAAAAAAAAAEAAAAKAAACAAAAABRzdHNzAAAAAAAAAAEAAAABAAAAYGN0dHMA
+AAAAAAAACgAAAAEAAAQAAAAAAQAACgAAAAABAAAEAAAAAAEAAAAAAAAAAQAAAgAAAAABAAAKAAAA
+AAEAAAQAAAAAAQAAAAAAAAABAAACAAAAAAEAAAQAAAAAHHN0c2MAAAAAAAAAAQAAAAEAAAAKAAAA
+AQAAADxzdHN6AAAAAAAAAAAAAAAKAAACzQAAAAwAAAAMAAAADAAAAAwAAAASAAAADgAAAAwAAAAM
+AAAAEgAAABRzdGNvAAAAAAAAAAEAAAQOAAAAj3VkdGEAAACHbWV0YQAAAAAAAAAhaGRscgAAAAAA
+AAAAbWRpcmFwcGwAAAAAAAAAAAAAAABaaWxzdAAAACSpdG9vAAAAHGRhdGEAAAABAAAAAExhdmY2
+My4xLjEwMgAAAC6pY210AAAAJmRhdGEAAAABAAAAAHlzay1vbW5pLXZpZGVvLWZpeHR1cmUAAAAI
+ZnJlZQAAA09tZGF0AAACrgYF//+q3EXpvebZSLeWLNgg2SPu73gyNjQgLSBjb3JlIDE2NSByMzIy
+MiBiMzU2MDVhIC0gSC4yNjQvTVBFRy00IEFWQyBjb2RlYyAtIENvcHlsZWZ0IDIwMDMtMjAyNSAt
+IGh0dHA6Ly93d3cudmlkZW9sYW4ub3JnL3gyNjQuaHRtbCAtIG9wdGlvbnM6IGNhYmFjPTEgcmVm
+PTMgZGVibG9jaz0xOjA6MCBhbmFseXNlPTB4MzoweDExMyBtZT1oZXggc3VibWU9NyBwc3k9MSBw
+c3lfcmQ9MS4wMDowLjAwIG1peGVkX3JlZj0xIG1lX3JhbmdlPTE2IGNocm9tYV9tZT0xIHRyZWxs
+aXM9MSA4eDhkY3Q9MSBjcW09MCBkZWFkem9uZT0yMSwxMSBmYXN0X3Bza2lwPTEgY2hyb21hX3Fw
+X29mZnNldD0tMiB0aHJlYWRzPTEgbG9va2FoZWFkX3RocmVhZHM9MSBzbGljZWRfdGhyZWFkcz0w
+IG5yPTAgZGVjaW1hdGU9MSBpbnRlcmxhY2VkPTAgYmx1cmF5X2NvbXBhdD0wIGNvbnN0cmFpbmVk
+X2ludHJhPTAgYmZyYW1lcz0zIGJfcHlyYW1pZD0yIGJfYWRhcHQ9MSBiX2JpYXM9MCBkaXJlY3Q9
+MSB3ZWlnaHRiPTEgb3Blbl9nb3A9MCB3ZWlnaHRwPTIga2V5aW50PTI1MCBrZXlpbnRfbWluPTI1
+IHNjZW5lY3V0PTQwIGludHJhX3JlZnJlc2g9MCByY19sb29rYWhlYWQ9NDAgcmM9Y3JmIG1idHJl
+ZT0xIGNyZj0yMy4wIHFjb21wPTAuNjAgcXBtaW49MCBxcG1heD02OSBxcHN0ZXA9NCBpcF9yYXRp
+bz0xLjQwIGFxPTE6MS4wMACAAAAAF2WIhAA3//7hA/gU12LeX++E1hLXBbT/AAAACEGaJGxDf/6r
+AAAACEGeQniF/1XBAAAACAGeYXRCv1rAAAAACAGeY2pCv1rBAAAADkGaaEmoQWiZTAhf//6XAAAA
+CkGehkURLC//VcEAAAAIAZ6ldEK/WsEAAAAIAZ6nakK/WsAAAAAOQZqpSahBbJlMCFf//lY=
+`.replace(/\s+/g, '');
+//# sourceMappingURL=video-fixture.js.map

package/dist/services/media/video-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-fixture.js","sourceRoot":"","sources":["../../../src/services/media/video-fixture.ts"],"names":[],"mappings":";;;AAAA,kFAAkF;AACrE,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkChC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC"}

package/dist/services/models.service.d.ts

@@ -0,0 +1,49 @@
+import type { OpenAiModel, OpenAiModelList } from '../interfaces';
+import { type ModelModality, type ModelRuntime, type RegistryEntry } from './hf/registry';
+/** Local Piper voice used by the media worker. */
+export declare const PIPER_MODEL_ID = "piper/lessac-high";
+/** OpenAI-compatible speech model id (DTO default). */
+export declare const OPENAI_TTS_MODEL_ID = "tts-1";
+/** OpenAI-compatible transcription model id. */
+export declare const OPENAI_STT_MODEL_ID = "whisper-1";
+export type UsableModel = {
+    id: string;
+    modality: ModelModality;
+    runtime: ModelRuntime;
+};
+export declare const BUILTIN_USABLE_MODELS: readonly UsableModel[];
+/** Loaded engines first, then registry, echo last. */
+export declare function orderModelIds(opts: {
+    echoId: string;
+    registryIds: string[];
+    loadedIds: string[];
+}): string[];
+export declare function preferredChatModel(ids: string[], echoId: string): string;
+/** Loaded engines, registry (all modalities), builtins, echo last. */
+export declare function buildUsableCatalog(opts: {
+    echoId: string;
+    registry: Array<Pick<RegistryEntry, 'id' | 'modality' | 'runtime'>>;
+    loaded: Array<{
+        id: string;
+        kind?: string;
+    }>;
+    builtins?: readonly UsableModel[];
+}): UsableModel[];
+export declare class ModelsService {
+    private cache;
+    private readonly ttlMs;
+    list(allowedModels?: string[] | null): Promise<OpenAiModelList>;
+    get(modelId: string, allowedModels?: string[] | null): Promise<OpenAiModel>;
+    clearCache(): void;
+    getModelIds(forceRefresh?: boolean): Promise<string[]>;
+    /** Models this gateway can name, for GET /v1/models (then key-filtered). */
+    getUsableCatalog(): Promise<UsableModel[]>;
+    getModelCatalog(forceRefresh?: boolean): Promise<{
+        models: string[];
+        source: string;
+        defaultModel: string;
+        fetchedAt: number;
+    }>;
+}
+export declare const modelsService: ModelsService;
+//# sourceMappingURL=models.service.d.ts.map

package/dist/services/models.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.service.d.ts","sourceRoot":"","sources":["../../src/services/models.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOlE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAGvB,kDAAkD;AAClD,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAIvD,CAAC;AAEF,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,MAAM,EAAE,CAcX;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACnC,GAAG,WAAW,EAAE,CA4BhB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CACN;IACP,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IAEjC,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAc/D,GAAG,CACP,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAC9B,OAAO,CAAC,WAAW,CAAC;IAUvB,UAAU,IAAI,IAAI;IAIZ,WAAW,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqB1D,4EAA4E;IACtE,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAa1C,eAAe,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC;QACnD,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CAcH;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/services/models.service.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelsService = exports.ModelsService = exports.BUILTIN_USABLE_MODELS = exports.OPENAI_STT_MODEL_ID = exports.OPENAI_TTS_MODEL_ID = exports.PIPER_MODEL_ID = void 0;
+exports.orderModelIds = orderModelIds;
+exports.preferredChatModel = preferredChatModel;
+exports.buildUsableCatalog = buildUsableCatalog;
+const env_1 = require("../config/env");
+const exception_factory_1 = require("../exceptions/exception.factory");
+const model_allowlist_1 = require("../utils/model-allowlist");
+const echo_1 = require("./runtimes/echo");
+const registry_1 = require("./hf/registry");
+const engine_manager_1 = require("./runtimes/engine-manager");
+/** Local Piper voice used by the media worker. */
+exports.PIPER_MODEL_ID = 'piper/lessac-high';
+/** OpenAI-compatible speech model id (DTO default). */
+exports.OPENAI_TTS_MODEL_ID = 'tts-1';
+/** OpenAI-compatible transcription model id. */
+exports.OPENAI_STT_MODEL_ID = 'whisper-1';
+exports.BUILTIN_USABLE_MODELS = [
+    { id: exports.PIPER_MODEL_ID, modality: 'tts', runtime: 'tts' },
+    { id: exports.OPENAI_TTS_MODEL_ID, modality: 'tts', runtime: 'tts' },
+    { id: exports.OPENAI_STT_MODEL_ID, modality: 'stt', runtime: 'whisper' },
+];
+/** Loaded engines first, then registry, echo last. */
+function orderModelIds(opts) {
+    const seen = new Set();
+    const out = [];
+    const add = (id, allowEcho = false) => {
+        const v = (id || '').trim();
+        if (!v || seen.has(v))
+            return;
+        if (!allowEcho && v === opts.echoId)
+            return;
+        seen.add(v);
+        out.push(v);
+    };
+    for (const id of opts.loadedIds)
+        add(id);
+    for (const id of opts.registryIds)
+        add(id);
+    add(opts.echoId, true);
+    return out;
+}
+function preferredChatModel(ids, echoId) {
+    return ids.find((id) => id !== echoId) || echoId;
+}
+/** Loaded engines, registry (all modalities), builtins, echo last. */
+function buildUsableCatalog(opts) {
+    const seen = new Set();
+    const out = [];
+    const add = (row, allowEcho = false) => {
+        const id = (row.id || '').trim();
+        if (!id || seen.has(id))
+            return;
+        if (!allowEcho && id === opts.echoId)
+            return;
+        seen.add(id);
+        out.push({ ...row, id });
+    };
+    const registryById = new Map(opts.registry.map((r) => [r.id, r]));
+    for (const e of opts.loaded) {
+        const id = (e.id || '').trim();
+        if (!id)
+            continue;
+        const reg = registryById.get(id);
+        const kind = e.kind === 'vllm' ? 'vllm' : 'llamacpp';
+        add({
+            id,
+            modality: reg?.modality || 'text',
+            runtime: reg?.runtime || kind,
+        });
+    }
+    for (const r of opts.registry) {
+        add({ id: r.id, modality: r.modality, runtime: r.runtime });
+    }
+    for (const b of opts.builtins ?? exports.BUILTIN_USABLE_MODELS)
+        add(b);
+    add({ id: opts.echoId, modality: 'text', runtime: 'echo' }, true);
+    return out;
+}
+class ModelsService {
+    cache = null;
+    ttlMs = 5 * 60 * 1000;
+    async list(allowedModels) {
+        const catalog = await this.getUsableCatalog();
+        const ids = (0, model_allowlist_1.filterAllowedModels)(catalog.map((m) => m.id), allowedModels);
+        const byId = new Map(catalog.map((m) => [m.id, m]));
+        const created = Math.floor(Date.now() / 1000);
+        return {
+            object: 'list',
+            data: ids.map((id) => toOpenAiModel(byId.get(id), created)),
+        };
+    }
+    async get(modelId, allowedModels) {
+        const catalog = await this.getUsableCatalog();
+        const row = catalog.find((m) => m.id === modelId);
+        if (!row) {
+            throw exception_factory_1.ExceptionFactory.notFound('Model');
+        }
+        (0, model_allowlist_1.assertModelAllowed)({ allowedModels: allowedModels ?? [] }, modelId);
+        return toOpenAiModel(row, Math.floor(Date.now() / 1000));
+    }
+    clearCache() {
+        this.cache = null;
+    }
+    async getModelIds(forceRefresh = false) {
+        const now = Date.now();
+        if (!forceRefresh &&
+            this.cache &&
+            now - this.cache.fetchedAt < this.ttlMs) {
+            return this.cache.models;
+        }
+        const registryIds = (0, registry_1.loadRegistry)().models.map((m) => m.id);
+        const loadedIds = engine_manager_1.engineManager.list().map((e) => e.id);
+        const models = orderModelIds({
+            echoId: echo_1.ECHO_MODEL_ID,
+            registryIds,
+            loadedIds,
+        });
+        this.cache = { models, fetchedAt: now, source: 'registry' };
+        return models;
+    }
+    /** Models this gateway can name, for GET /v1/models (then key-filtered). */
+    async getUsableCatalog() {
+        const registry = (0, registry_1.loadRegistry)().models;
+        const loadedIds = engine_manager_1.engineManager.list().map((e) => ({
+            id: e.id,
+            kind: e.kind,
+        }));
+        return buildUsableCatalog({
+            echoId: echo_1.ECHO_MODEL_ID,
+            registry,
+            loaded: loadedIds,
+        });
+    }
+    async getModelCatalog(forceRefresh = false) {
+        const models = await this.getModelIds(forceRefresh);
+        const envDefault = env_1.env.OMNI_DEFAULT_MODEL?.trim();
+        const defaultModel = envDefault && envDefault !== echo_1.ECHO_MODEL_ID && models.includes(envDefault)
+            ? envDefault
+            : preferredChatModel(models, echo_1.ECHO_MODEL_ID);
+        return {
+            models,
+            source: this.cache?.source ?? 'registry',
+            defaultModel,
+            fetchedAt: this.cache?.fetchedAt ?? Date.now(),
+        };
+    }
+}
+exports.ModelsService = ModelsService;
+exports.modelsService = new ModelsService();
+function toOpenAiModel(row, created) {
+    return {
+        id: row.id,
+        object: 'model',
+        created,
+        owned_by: 'ysk-omni',
+        modality: row.modality,
+        runtime: row.runtime,
+    };
+}
+//# sourceMappingURL=models.service.js.map

package/dist/services/models.service.js.map

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

package/dist/services/pm2-config.d.ts

@@ -0,0 +1,12 @@
+import type { Pm2RuntimeConfig } from '../interfaces/pm2-runtime-config.interface';
+export declare const PM2_APP_NAME_DEFAULT = "ysk-omni";
+export declare function packageRoot(): string;
+export declare function pm2RuntimeConfigPath(): string;
+export declare function defaultPm2Config(): Pm2RuntimeConfig;
+/** Normalize partial user input into a full config */
+export declare function normalizePm2Config(input: Partial<Pm2RuntimeConfig> | Record<string, unknown> | null | undefined, base?: Pm2RuntimeConfig): Pm2RuntimeConfig;
+export declare function readPm2Config(): Pm2RuntimeConfig;
+export declare function writePm2Config(cfg: Pm2RuntimeConfig): Pm2RuntimeConfig;
+/** Shape expected by PM2 ecosystem apps[] entry (minus env from .env loader) */
+export declare function toPm2AppOptions(cfg: Pm2RuntimeConfig, root: string, fileEnv: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=pm2-config.d.ts.map

package/dist/services/pm2-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm2-config.d.ts","sourceRoot":"","sources":["../../src/services/pm2-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAGnF,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,gBAAgB,CAoBnD;AAyCD,sDAAsD;AACtD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAC7E,IAAI,CAAC,EAAE,gBAAgB,GACtB,gBAAgB,CA2BlB;AAED,wBAAgB,aAAa,IAAI,gBAAgB,CAWhD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAKtE;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB"}

package/dist/services/pm2-config.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PM2_APP_NAME_DEFAULT = void 0;
+exports.packageRoot = packageRoot;
+exports.pm2RuntimeConfigPath = pm2RuntimeConfigPath;
+exports.defaultPm2Config = defaultPm2Config;
+exports.normalizePm2Config = normalizePm2Config;
+exports.readPm2Config = readPm2Config;
+exports.writePm2Config = writePm2Config;
+exports.toPm2AppOptions = toPm2AppOptions;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+exports.PM2_APP_NAME_DEFAULT = 'ysk-omni';
+function packageRoot() {
+    return node_path_1.default.resolve(__dirname, '../..');
+}
+function pm2RuntimeConfigPath() {
+    return node_path_1.default.join(packageRoot(), 'pm2.runtime.json');
+}
+function defaultPm2Config() {
+    return {
+        name: exports.PM2_APP_NAME_DEFAULT,
+        script: 'dist/server.js',
+        instances: 1,
+        exec_mode: 'fork',
+        autorestart: true,
+        watch: false,
+        max_memory_restart: '512M',
+        max_restarts: 10,
+        min_uptime: '5s',
+        restart_delay: 2000,
+        exp_backoff_restart_delay: 1000,
+        merge_logs: true,
+        time: true,
+        error_file: 'logs/pm2-error.log',
+        out_file: 'logs/pm2-out.log',
+        env_extra: {},
+        preferred_runner: 'ysk-omni',
+    };
+}
+function asString(v, fallback) {
+    if (v == null || v === '')
+        return fallback;
+    return String(v);
+}
+function asBool(v, fallback) {
+    if (typeof v === 'boolean')
+        return v;
+    if (v === 'true' || v === '1')
+        return true;
+    if (v === 'false' || v === '0')
+        return false;
+    return fallback;
+}
+function asNumber(v, fallback) {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : fallback;
+}
+function asInstances(v, fallback) {
+    if (v === 'max' || v === 'Max')
+        return 'max';
+    if (typeof v === 'string' && v.trim() === 'max')
+        return 'max';
+    const n = Number(v);
+    if (Number.isFinite(n) && n >= 1)
+        return Math.floor(n);
+    return fallback;
+}
+function asExecMode(v) {
+    return v === 'cluster' ? 'cluster' : 'fork';
+}
+function asEnvExtra(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v))
+        return {};
+    const out = {};
+    for (const [k, val] of Object.entries(v)) {
+        if (!k || val == null)
+            continue;
+        out[k] = String(val);
+    }
+    return out;
+}
+/** Normalize partial user input into a full config */
+function normalizePm2Config(input, base) {
+    const d = base || defaultPm2Config();
+    const raw = (input || {});
+    return {
+        name: asString(raw.name, d.name).trim() || d.name,
+        script: asString(raw.script, d.script).trim() || d.script,
+        cwd: raw.cwd != null && String(raw.cwd).trim() ? String(raw.cwd).trim() : d.cwd,
+        instances: asInstances(raw.instances, d.instances),
+        exec_mode: asExecMode(raw.exec_mode ?? d.exec_mode),
+        autorestart: asBool(raw.autorestart, d.autorestart),
+        watch: asBool(raw.watch, d.watch),
+        max_memory_restart: asString(raw.max_memory_restart, d.max_memory_restart),
+        max_restarts: Math.max(0, asNumber(raw.max_restarts, d.max_restarts)),
+        min_uptime: raw.min_uptime != null ? raw.min_uptime : d.min_uptime,
+        restart_delay: Math.max(0, asNumber(raw.restart_delay, d.restart_delay)),
+        exp_backoff_restart_delay: Math.max(0, asNumber(raw.exp_backoff_restart_delay, d.exp_backoff_restart_delay)),
+        merge_logs: asBool(raw.merge_logs, d.merge_logs),
+        time: asBool(raw.time, d.time),
+        error_file: asString(raw.error_file, d.error_file),
+        out_file: asString(raw.out_file, d.out_file),
+        env_extra: asEnvExtra(raw.env_extra ?? d.env_extra),
+        preferred_runner: raw.preferred_runner === 'pm2' ? 'pm2' : 'ysk-omni',
+    };
+}
+function readPm2Config() {
+    const file = pm2RuntimeConfigPath();
+    try {
+        if (node_fs_1.default.existsSync(file)) {
+            const raw = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+            return normalizePm2Config(raw);
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return defaultPm2Config();
+}
+function writePm2Config(cfg) {
+    const normalized = normalizePm2Config(cfg);
+    const file = pm2RuntimeConfigPath();
+    node_fs_1.default.writeFileSync(file, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8');
+    return normalized;
+}
+/** Shape expected by PM2 ecosystem apps[] entry (minus env from .env loader) */
+function toPm2AppOptions(cfg, root, fileEnv) {
+    return {
+        name: cfg.name,
+        script: cfg.script,
+        cwd: cfg.cwd || root,
+        instances: cfg.instances,
+        exec_mode: cfg.exec_mode,
+        autorestart: cfg.autorestart,
+        watch: cfg.watch,
+        max_memory_restart: cfg.max_memory_restart,
+        max_restarts: cfg.max_restarts,
+        min_uptime: cfg.min_uptime,
+        restart_delay: cfg.restart_delay,
+        exp_backoff_restart_delay: cfg.exp_backoff_restart_delay,
+        merge_logs: cfg.merge_logs,
+        time: cfg.time,
+        error_file: cfg.error_file,
+        out_file: cfg.out_file,
+        env: {
+            NODE_ENV: fileEnv.NODE_ENV || 'production',
+            ...fileEnv,
+            ...cfg.env_extra,
+        },
+    };
+}
+//# sourceMappingURL=pm2-config.js.map

package/dist/services/pm2-config.js.map

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