@nekutima/provili-sdk 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +57 -0
  3. package/dist/core/http-client.d.ts +84 -0
  4. package/dist/core/http-client.d.ts.map +1 -0
  5. package/dist/core/http-client.js +177 -0
  6. package/dist/core/http-client.js.map +1 -0
  7. package/dist/core/index.d.ts +3 -0
  8. package/dist/core/index.d.ts.map +1 -0
  9. package/dist/core/index.js +7 -0
  10. package/dist/core/index.js.map +1 -0
  11. package/dist/core/rate-limiter.d.ts +40 -0
  12. package/dist/core/rate-limiter.d.ts.map +1 -0
  13. package/dist/core/rate-limiter.js +65 -0
  14. package/dist/core/rate-limiter.js.map +1 -0
  15. package/dist/generated/api-types.d.ts +1742 -0
  16. package/dist/generated/api-types.d.ts.map +1 -0
  17. package/dist/generated/api-types.js +7 -0
  18. package/dist/generated/api-types.js.map +1 -0
  19. package/dist/index.d.ts +92 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +129 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/llm-engines/adapters.d.ts +26 -0
  24. package/dist/llm-engines/adapters.d.ts.map +1 -0
  25. package/dist/llm-engines/adapters.js +121 -0
  26. package/dist/llm-engines/adapters.js.map +1 -0
  27. package/dist/llm-engines/client.d.ts +12 -0
  28. package/dist/llm-engines/client.d.ts.map +1 -0
  29. package/dist/llm-engines/client.js +138 -0
  30. package/dist/llm-engines/client.js.map +1 -0
  31. package/dist/llm-engines/descriptors.d.ts +24 -0
  32. package/dist/llm-engines/descriptors.d.ts.map +1 -0
  33. package/dist/llm-engines/descriptors.js +192 -0
  34. package/dist/llm-engines/descriptors.js.map +1 -0
  35. package/dist/llm-engines/endpoint.d.ts +5 -0
  36. package/dist/llm-engines/endpoint.d.ts.map +1 -0
  37. package/dist/llm-engines/endpoint.js +19 -0
  38. package/dist/llm-engines/endpoint.js.map +1 -0
  39. package/dist/llm-engines/errors.d.ts +16 -0
  40. package/dist/llm-engines/errors.d.ts.map +1 -0
  41. package/dist/llm-engines/errors.js +72 -0
  42. package/dist/llm-engines/errors.js.map +1 -0
  43. package/dist/llm-engines/index.d.ts +7 -0
  44. package/dist/llm-engines/index.d.ts.map +1 -0
  45. package/dist/llm-engines/index.js +10 -0
  46. package/dist/llm-engines/index.js.map +1 -0
  47. package/dist/llm-engines/types.d.ts +130 -0
  48. package/dist/llm-engines/types.d.ts.map +1 -0
  49. package/dist/llm-engines/types.js +32 -0
  50. package/dist/llm-engines/types.js.map +1 -0
  51. package/dist/mcp/host.d.ts +13 -0
  52. package/dist/mcp/host.d.ts.map +1 -0
  53. package/dist/mcp/host.js +72 -0
  54. package/dist/mcp/host.js.map +1 -0
  55. package/dist/mcp/index.d.ts +4 -0
  56. package/dist/mcp/index.d.ts.map +1 -0
  57. package/dist/mcp/index.js +7 -0
  58. package/dist/mcp/index.js.map +1 -0
  59. package/dist/mcp/mcp.service.d.ts +21 -0
  60. package/dist/mcp/mcp.service.d.ts.map +1 -0
  61. package/dist/mcp/mcp.service.js +35 -0
  62. package/dist/mcp/mcp.service.js.map +1 -0
  63. package/dist/mcp/types.d.ts +60 -0
  64. package/dist/mcp/types.d.ts.map +1 -0
  65. package/dist/mcp/types.js +7 -0
  66. package/dist/mcp/types.js.map +1 -0
  67. package/dist/models/agent.model.d.ts +62 -0
  68. package/dist/models/agent.model.d.ts.map +1 -0
  69. package/dist/models/agent.model.js +3 -0
  70. package/dist/models/agent.model.js.map +1 -0
  71. package/dist/models/ai-chat.model.d.ts +27 -0
  72. package/dist/models/ai-chat.model.d.ts.map +1 -0
  73. package/dist/models/ai-chat.model.js +3 -0
  74. package/dist/models/ai-chat.model.js.map +1 -0
  75. package/dist/models/api-error.model.d.ts +33 -0
  76. package/dist/models/api-error.model.d.ts.map +1 -0
  77. package/dist/models/api-error.model.js +59 -0
  78. package/dist/models/api-error.model.js.map +1 -0
  79. package/dist/models/api-response.model.d.ts +52 -0
  80. package/dist/models/api-response.model.d.ts.map +1 -0
  81. package/dist/models/api-response.model.js +78 -0
  82. package/dist/models/api-response.model.js.map +1 -0
  83. package/dist/models/auth.model.d.ts +25 -0
  84. package/dist/models/auth.model.d.ts.map +1 -0
  85. package/dist/models/auth.model.js +6 -0
  86. package/dist/models/auth.model.js.map +1 -0
  87. package/dist/models/backup.model.d.ts +34 -0
  88. package/dist/models/backup.model.d.ts.map +1 -0
  89. package/dist/models/backup.model.js +3 -0
  90. package/dist/models/backup.model.js.map +1 -0
  91. package/dist/models/chat.model.d.ts +87 -0
  92. package/dist/models/chat.model.d.ts.map +1 -0
  93. package/dist/models/chat.model.js +7 -0
  94. package/dist/models/chat.model.js.map +1 -0
  95. package/dist/models/file.model.d.ts +50 -0
  96. package/dist/models/file.model.d.ts.map +1 -0
  97. package/dist/models/file.model.js +7 -0
  98. package/dist/models/file.model.js.map +1 -0
  99. package/dist/models/index.d.ts +17 -0
  100. package/dist/models/index.d.ts.map +1 -0
  101. package/dist/models/index.js +20 -0
  102. package/dist/models/index.js.map +1 -0
  103. package/dist/models/knowledge.model.d.ts +63 -0
  104. package/dist/models/knowledge.model.d.ts.map +1 -0
  105. package/dist/models/knowledge.model.js +3 -0
  106. package/dist/models/knowledge.model.js.map +1 -0
  107. package/dist/models/llm-engine.model.d.ts +25 -0
  108. package/dist/models/llm-engine.model.d.ts.map +1 -0
  109. package/dist/models/llm-engine.model.js +3 -0
  110. package/dist/models/llm-engine.model.js.map +1 -0
  111. package/dist/models/prompt.model.d.ts +30 -0
  112. package/dist/models/prompt.model.d.ts.map +1 -0
  113. package/dist/models/prompt.model.js +3 -0
  114. package/dist/models/prompt.model.js.map +1 -0
  115. package/dist/models/role.model.d.ts +19 -0
  116. package/dist/models/role.model.d.ts.map +1 -0
  117. package/dist/models/role.model.js +3 -0
  118. package/dist/models/role.model.js.map +1 -0
  119. package/dist/models/streaming.model.d.ts +27 -0
  120. package/dist/models/streaming.model.d.ts.map +1 -0
  121. package/dist/models/streaming.model.js +3 -0
  122. package/dist/models/streaming.model.js.map +1 -0
  123. package/dist/models/update.model.d.ts +16 -0
  124. package/dist/models/update.model.d.ts.map +1 -0
  125. package/dist/models/update.model.js +3 -0
  126. package/dist/models/update.model.js.map +1 -0
  127. package/dist/models/usb-patch.model.d.ts +13 -0
  128. package/dist/models/usb-patch.model.d.ts.map +1 -0
  129. package/dist/models/usb-patch.model.js +3 -0
  130. package/dist/models/usb-patch.model.js.map +1 -0
  131. package/dist/models/user.model.d.ts +64 -0
  132. package/dist/models/user.model.d.ts.map +1 -0
  133. package/dist/models/user.model.js +3 -0
  134. package/dist/models/user.model.js.map +1 -0
  135. package/dist/services/agent.service.d.ts +45 -0
  136. package/dist/services/agent.service.d.ts.map +1 -0
  137. package/dist/services/agent.service.js +91 -0
  138. package/dist/services/agent.service.js.map +1 -0
  139. package/dist/services/ai-chat.service.d.ts +12 -0
  140. package/dist/services/ai-chat.service.d.ts.map +1 -0
  141. package/dist/services/ai-chat.service.js +116 -0
  142. package/dist/services/ai-chat.service.js.map +1 -0
  143. package/dist/services/auth.service.d.ts +25 -0
  144. package/dist/services/auth.service.d.ts.map +1 -0
  145. package/dist/services/auth.service.js +76 -0
  146. package/dist/services/auth.service.js.map +1 -0
  147. package/dist/services/chat.service.d.ts +90 -0
  148. package/dist/services/chat.service.d.ts.map +1 -0
  149. package/dist/services/chat.service.js +240 -0
  150. package/dist/services/chat.service.js.map +1 -0
  151. package/dist/services/index.d.ts +12 -0
  152. package/dist/services/index.d.ts.map +1 -0
  153. package/dist/services/index.js +16 -0
  154. package/dist/services/index.js.map +1 -0
  155. package/dist/services/knowledge.service.d.ts +18 -0
  156. package/dist/services/knowledge.service.d.ts.map +1 -0
  157. package/dist/services/knowledge.service.js +33 -0
  158. package/dist/services/knowledge.service.js.map +1 -0
  159. package/dist/services/llm-engines.service.d.ts +12 -0
  160. package/dist/services/llm-engines.service.d.ts.map +1 -0
  161. package/dist/services/llm-engines.service.js +26 -0
  162. package/dist/services/llm-engines.service.js.map +1 -0
  163. package/dist/services/prompts.service.d.ts +16 -0
  164. package/dist/services/prompts.service.d.ts.map +1 -0
  165. package/dist/services/prompts.service.js +31 -0
  166. package/dist/services/prompts.service.js.map +1 -0
  167. package/dist/services/role.service.d.ts +12 -0
  168. package/dist/services/role.service.d.ts.map +1 -0
  169. package/dist/services/role.service.js +29 -0
  170. package/dist/services/role.service.js.map +1 -0
  171. package/dist/services/streaming.service.d.ts +18 -0
  172. package/dist/services/streaming.service.d.ts.map +1 -0
  173. package/dist/services/streaming.service.js +103 -0
  174. package/dist/services/streaming.service.js.map +1 -0
  175. package/dist/services/usb-patches.service.d.ts +9 -0
  176. package/dist/services/usb-patches.service.d.ts.map +1 -0
  177. package/dist/services/usb-patches.service.js +16 -0
  178. package/dist/services/usb-patches.service.js.map +1 -0
  179. package/dist/services/user.service.d.ts +15 -0
  180. package/dist/services/user.service.d.ts.map +1 -0
  181. package/dist/services/user.service.js +40 -0
  182. package/dist/services/user.service.js.map +1 -0
  183. package/package.json +93 -0
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.textFromSseLine = textFromSseLine;
4
+ exports.streamText = streamText;
5
+ exports.createEngineClient = createEngineClient;
6
+ const adapters_1 = require("./adapters");
7
+ const descriptors_1 = require("./descriptors");
8
+ const errors_1 = require("./errors");
9
+ /** Decode one SSE line into a text delta, or null when it carries none. */
10
+ function textFromSseLine(descriptor, line) {
11
+ const trimmed = line.trim();
12
+ if (!trimmed.startsWith('data:'))
13
+ return null;
14
+ const data = trimmed.slice(5).trim();
15
+ if (!data || data === '[DONE]')
16
+ return null;
17
+ let payload;
18
+ try {
19
+ payload = JSON.parse(data);
20
+ }
21
+ catch {
22
+ return null;
23
+ }
24
+ return (0, adapters_1.parseChatChunk)(descriptor, payload);
25
+ }
26
+ /** Iterate a streaming HTTP response, yielding vendor-normalized text deltas. */
27
+ async function* streamText(response, descriptor) {
28
+ const reader = response.body?.getReader();
29
+ if (!reader)
30
+ return;
31
+ const decoder = new TextDecoder();
32
+ let buffer = '';
33
+ for (;;) {
34
+ const { done, value } = await reader.read();
35
+ if (done)
36
+ break;
37
+ buffer += decoder.decode(value, { stream: true });
38
+ const lines = buffer.split('\n');
39
+ buffer = lines.pop();
40
+ for (const line of lines) {
41
+ const text = textFromSseLine(descriptor, line);
42
+ if (text)
43
+ yield text;
44
+ }
45
+ }
46
+ const tail = textFromSseLine(descriptor, buffer);
47
+ if (tail)
48
+ yield tail;
49
+ }
50
+ function defaultFetch() {
51
+ return globalThis.fetch;
52
+ }
53
+ /**
54
+ * Create a uniform client for a single engine. Vendor differences (URL, auth,
55
+ * request/response shape, streaming format) are handled here, so callers never
56
+ * branch on `type`.
57
+ */
58
+ function createEngineClient(config, deps = {}) {
59
+ const resolved = (0, descriptors_1.resolveEngineConfig)(config);
60
+ const fetchImpl = deps.fetch ?? defaultFetch();
61
+ const send = (request, signal) => fetchImpl(request.url, {
62
+ method: request.method,
63
+ headers: request.headers,
64
+ ...(request.body === undefined ? {} : { body: request.body }),
65
+ ...(signal ? { signal } : {}),
66
+ });
67
+ const safeText = async (response) => {
68
+ try {
69
+ return await response.text();
70
+ }
71
+ catch {
72
+ return '';
73
+ }
74
+ };
75
+ const requireOk = async (response) => {
76
+ if (!response.ok) {
77
+ throw new errors_1.EngineRequestError(response.status, await safeText(response));
78
+ }
79
+ };
80
+ return {
81
+ config: {
82
+ type: resolved.type,
83
+ endpoint: resolved.endpoint,
84
+ model: resolved.model,
85
+ ...(resolved.apiKey ? { apiKey: resolved.apiKey } : {}),
86
+ },
87
+ async chat(messages, options = {}) {
88
+ const request = (0, adapters_1.buildChatRequest)(resolved, messages, { ...options, stream: false });
89
+ const response = await send(request, options.signal);
90
+ await requireOk(response);
91
+ const json = await response.json();
92
+ return (0, adapters_1.parseChatResponse)(resolved.descriptor, json);
93
+ },
94
+ async *chatStream(messages, options = {}) {
95
+ const request = (0, adapters_1.buildChatRequest)(resolved, messages, { ...options, stream: true });
96
+ const response = await send(request, options.signal);
97
+ await requireOk(response);
98
+ yield* streamText(response, resolved.descriptor);
99
+ },
100
+ async embed(input) {
101
+ const request = (0, adapters_1.buildEmbedRequest)(resolved, input);
102
+ const response = await send(request);
103
+ await requireOk(response);
104
+ const json = await response.json();
105
+ return { embeddings: (0, adapters_1.parseEmbeddings)(json) };
106
+ },
107
+ async health() {
108
+ const startedAt = Date.now();
109
+ try {
110
+ let response = await send((0, adapters_1.buildHealthRequest)(resolved));
111
+ if (!response.ok && response.status === 404 && resolved.descriptor.healthFallbackPath) {
112
+ response = await send((0, adapters_1.buildHealthRequest)(resolved, resolved.descriptor.healthFallbackPath));
113
+ }
114
+ const latencyMs = Date.now() - startedAt;
115
+ if (response.ok) {
116
+ return { ok: true, latencyMs, status: response.status };
117
+ }
118
+ const body = (await safeText(response)).slice(0, 200);
119
+ return {
120
+ ok: false,
121
+ latencyMs,
122
+ status: response.status,
123
+ category: (0, errors_1.classifyStatus)(response.status),
124
+ error: body || `HTTP ${response.status}`,
125
+ };
126
+ }
127
+ catch (error) {
128
+ return {
129
+ ok: false,
130
+ latencyMs: Date.now() - startedAt,
131
+ category: (0, errors_1.classifyEngineError)(error),
132
+ error: error instanceof Error ? error.message : String(error),
133
+ };
134
+ }
135
+ },
136
+ };
137
+ }
138
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/llm-engines/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { EngineConfig, EngineConfigFieldError, EngineType, EngineTypeDescriptor } from './types';
2
+ /**
3
+ * Single source of truth for what each vendor needs. Adding a provider is a new
4
+ * entry here plus (if it is not OpenAI-compatible) a response-style branch —
5
+ * never a change at call sites.
6
+ */
7
+ export declare const ENGINE_TYPE_DESCRIPTORS: Record<EngineType, EngineTypeDescriptor>;
8
+ /** Look up a descriptor, failing loudly on an unknown type. */
9
+ export declare function getEngineDescriptor(type: string | null | undefined): EngineTypeDescriptor;
10
+ export interface ResolvedEngineConfig {
11
+ type: EngineType;
12
+ endpoint: string;
13
+ model: string;
14
+ apiKey?: string;
15
+ descriptor: EngineTypeDescriptor;
16
+ }
17
+ /**
18
+ * Merge a caller's config with descriptor defaults. Does not validate; call
19
+ * `validateEngineConfig` first when input is user-supplied.
20
+ */
21
+ export declare function resolveEngineConfig(config: EngineConfig): ResolvedEngineConfig;
22
+ /** Validate a raw engine config against its type descriptor. */
23
+ export declare function validateEngineConfig(config: EngineConfig): EngineConfigFieldError[];
24
+ //# sourceMappingURL=descriptors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/llm-engines/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,oBAAoB,EAEvB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAyI5E,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,CAKzF;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,oBAAoB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,oBAAoB,CAM9E;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,sBAAsB,EAAE,CAsBnF"}
@@ -0,0 +1,192 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ENGINE_TYPE_DESCRIPTORS = void 0;
4
+ exports.getEngineDescriptor = getEngineDescriptor;
5
+ exports.resolveEngineConfig = resolveEngineConfig;
6
+ exports.validateEngineConfig = validateEngineConfig;
7
+ const types_1 = require("./types");
8
+ /**
9
+ * Single source of truth for what each vendor needs. Adding a provider is a new
10
+ * entry here plus (if it is not OpenAI-compatible) a response-style branch —
11
+ * never a change at call sites.
12
+ */
13
+ exports.ENGINE_TYPE_DESCRIPTORS = {
14
+ ollama: {
15
+ type: 'ollama',
16
+ label: 'Ollama / llama.cpp (local)',
17
+ defaultEndpoint: 'http://localhost:11434',
18
+ endpointRequired: false,
19
+ apiKeyRequired: false,
20
+ supportsChat: true,
21
+ supportsEmbed: true,
22
+ defaultModel: '',
23
+ modelRequired: true,
24
+ auth: { kind: 'bearer' },
25
+ chatPath: '/v1/chat/completions',
26
+ embedPath: '/v1/embeddings',
27
+ healthPath: '/api/tags',
28
+ healthFallbackPath: '/v1/models',
29
+ responseStyle: 'openai',
30
+ },
31
+ deepseek: {
32
+ type: 'deepseek',
33
+ label: 'DeepSeek',
34
+ defaultEndpoint: 'https://api.deepseek.com',
35
+ endpointRequired: false,
36
+ apiKeyRequired: true,
37
+ supportsChat: true,
38
+ supportsEmbed: false,
39
+ defaultModel: 'deepseek-chat',
40
+ modelRequired: true,
41
+ auth: { kind: 'bearer' },
42
+ chatPath: '/chat/completions',
43
+ healthPath: '/models',
44
+ responseStyle: 'openai',
45
+ },
46
+ openai: {
47
+ type: 'openai',
48
+ label: 'OpenAI',
49
+ defaultEndpoint: 'https://api.openai.com/v1',
50
+ endpointRequired: false,
51
+ apiKeyRequired: true,
52
+ supportsChat: true,
53
+ supportsEmbed: true,
54
+ defaultModel: 'gpt-4o-mini',
55
+ modelRequired: true,
56
+ auth: { kind: 'bearer' },
57
+ chatPath: '/chat/completions',
58
+ embedPath: '/embeddings',
59
+ healthPath: '/models',
60
+ responseStyle: 'openai',
61
+ },
62
+ anthropic: {
63
+ type: 'anthropic',
64
+ label: 'Anthropic',
65
+ defaultEndpoint: 'https://api.anthropic.com',
66
+ endpointRequired: false,
67
+ apiKeyRequired: true,
68
+ supportsChat: true,
69
+ supportsEmbed: false,
70
+ defaultModel: 'claude-sonnet-4-0',
71
+ modelRequired: true,
72
+ auth: {
73
+ kind: 'x-api-key',
74
+ headerName: 'x-api-key',
75
+ extraHeaders: { 'anthropic-version': '2023-06-01' },
76
+ },
77
+ chatPath: '/v1/messages',
78
+ healthPath: '/v1/models',
79
+ responseStyle: 'anthropic',
80
+ },
81
+ gemini: {
82
+ type: 'gemini',
83
+ label: 'Gemini',
84
+ defaultEndpoint: 'https://generativelanguage.googleapis.com/v1beta/openai',
85
+ endpointRequired: false,
86
+ apiKeyRequired: true,
87
+ supportsChat: true,
88
+ supportsEmbed: true,
89
+ defaultModel: 'gemini-2.5-flash',
90
+ modelRequired: true,
91
+ auth: { kind: 'bearer' },
92
+ chatPath: '/chat/completions',
93
+ embedPath: '/embeddings',
94
+ healthPath: '/models',
95
+ responseStyle: 'openai',
96
+ },
97
+ xai: {
98
+ type: 'xai',
99
+ label: 'xAI / Grok',
100
+ defaultEndpoint: 'https://api.x.ai/v1',
101
+ endpointRequired: false,
102
+ apiKeyRequired: true,
103
+ supportsChat: true,
104
+ supportsEmbed: false,
105
+ defaultModel: 'grok-4',
106
+ modelRequired: true,
107
+ auth: { kind: 'bearer' },
108
+ chatPath: '/chat/completions',
109
+ healthPath: '/models',
110
+ responseStyle: 'openai',
111
+ },
112
+ openrouter: {
113
+ type: 'openrouter',
114
+ label: 'OpenRouter',
115
+ defaultEndpoint: 'https://openrouter.ai/api/v1',
116
+ endpointRequired: false,
117
+ apiKeyRequired: true,
118
+ supportsChat: true,
119
+ supportsEmbed: true,
120
+ defaultModel: 'openrouter/auto',
121
+ modelRequired: true,
122
+ auth: {
123
+ kind: 'bearer',
124
+ extraHeaders: {
125
+ 'HTTP-Referer': 'https://nekutima.eu',
126
+ 'X-Title': 'Nekutima SDK',
127
+ },
128
+ },
129
+ chatPath: '/chat/completions',
130
+ embedPath: '/embeddings',
131
+ healthPath: '/models',
132
+ responseStyle: 'openai',
133
+ },
134
+ custom: {
135
+ type: 'custom',
136
+ label: 'Custom (OpenAI-compatible)',
137
+ defaultEndpoint: '',
138
+ endpointRequired: true,
139
+ apiKeyRequired: false,
140
+ supportsChat: true,
141
+ supportsEmbed: true,
142
+ defaultModel: '',
143
+ modelRequired: true,
144
+ auth: { kind: 'bearer' },
145
+ chatPath: '/v1/chat/completions',
146
+ embedPath: '/v1/embeddings',
147
+ healthPath: '/v1/models',
148
+ responseStyle: 'openai',
149
+ },
150
+ };
151
+ /** Look up a descriptor, failing loudly on an unknown type. */
152
+ function getEngineDescriptor(type) {
153
+ if (!(0, types_1.isEngineType)(type)) {
154
+ throw new Error(`Unknown LLM engine type: ${String(type)}`);
155
+ }
156
+ return exports.ENGINE_TYPE_DESCRIPTORS[type];
157
+ }
158
+ /**
159
+ * Merge a caller's config with descriptor defaults. Does not validate; call
160
+ * `validateEngineConfig` first when input is user-supplied.
161
+ */
162
+ function resolveEngineConfig(config) {
163
+ const descriptor = getEngineDescriptor(config.type);
164
+ const endpoint = (config.endpoint ?? '').trim() || descriptor.defaultEndpoint;
165
+ const model = (config.model ?? '').trim() || descriptor.defaultModel;
166
+ const apiKey = config.apiKey?.trim() || undefined;
167
+ return { type: descriptor.type, endpoint, model, apiKey, descriptor };
168
+ }
169
+ /** Validate a raw engine config against its type descriptor. */
170
+ function validateEngineConfig(config) {
171
+ const errors = [];
172
+ if (!(0, types_1.isEngineType)(config.type)) {
173
+ errors.push({ field: 'type', message: `Unknown engine type: ${String(config.type)}` });
174
+ return errors;
175
+ }
176
+ const descriptor = exports.ENGINE_TYPE_DESCRIPTORS[config.type];
177
+ const endpoint = (config.endpoint ?? '').trim();
178
+ if (descriptor.endpointRequired && !endpoint) {
179
+ errors.push({ field: 'endpoint', message: `endpoint is required for ${descriptor.label}` });
180
+ }
181
+ if (endpoint && !/^https?:\/\//i.test(endpoint)) {
182
+ errors.push({ field: 'endpoint', message: 'endpoint must be an http(s) URL' });
183
+ }
184
+ if (descriptor.apiKeyRequired && !(config.apiKey ?? '').trim()) {
185
+ errors.push({ field: 'apiKey', message: `apiKey is required for ${descriptor.label}` });
186
+ }
187
+ if (descriptor.modelRequired && !(config.model ?? '').trim()) {
188
+ errors.push({ field: 'model', message: `model is required for ${descriptor.label}` });
189
+ }
190
+ return errors;
191
+ }
192
+ //# sourceMappingURL=descriptors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"descriptors.js","sourceRoot":"","sources":["../../src/llm-engines/descriptors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ /** Join an endpoint base with a relative path without doubling a slash. */
2
+ export declare function joinEndpoint(endpoint: string, path: string): string;
3
+ /** Mask a credential, keeping only the last 4 characters. Never logs the key. */
4
+ export declare function maskApiKey(key: string | null | undefined): string;
5
+ //# sourceMappingURL=endpoint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/llm-engines/endpoint.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIjE"}
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.joinEndpoint = joinEndpoint;
4
+ exports.maskApiKey = maskApiKey;
5
+ /** Join an endpoint base with a relative path without doubling a slash. */
6
+ function joinEndpoint(endpoint, path) {
7
+ const base = endpoint.replace(/\/+$/, '');
8
+ const suffix = path.startsWith('/') ? path : `/${path}`;
9
+ return `${base}${suffix}`;
10
+ }
11
+ /** Mask a credential, keeping only the last 4 characters. Never logs the key. */
12
+ function maskApiKey(key) {
13
+ if (!key)
14
+ return '';
15
+ if (key.length <= 4)
16
+ return '*'.repeat(key.length);
17
+ return '*'.repeat(key.length - 4) + key.slice(-4);
18
+ }
19
+ //# sourceMappingURL=endpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/llm-engines/endpoint.ts"],"names":[],"mappings":";;AACA,oCAIC;AAGD,gCAIC;AAZD,2EAA2E;AAC3E,SAAgB,YAAY,CAAC,QAAgB,EAAE,IAAY;IACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IACxD,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,iFAAiF;AACjF,SAAgB,UAAU,CAAC,GAA8B;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}
@@ -0,0 +1,16 @@
1
+ import { EngineErrorCategory } from './types';
2
+ /**
3
+ * Map a vendor/transport failure to the SDK's stable taxonomy so callers can
4
+ * react without knowing which vendor produced it.
5
+ */
6
+ export declare function classifyEngineError(error: unknown): EngineErrorCategory;
7
+ /** Map an HTTP status code to the taxonomy. */
8
+ export declare function classifyStatus(status: number): EngineErrorCategory;
9
+ /** Error thrown by the engine client for non-2xx responses. */
10
+ export declare class EngineRequestError extends Error {
11
+ readonly status: number;
12
+ readonly category: EngineErrorCategory;
13
+ readonly body: string;
14
+ constructor(status: number, body: string);
15
+ }
16
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm-engines/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAe9C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA0BvE;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMlE;AAED,+DAA+D;AAC/D,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO3C"}
@@ -0,0 +1,72 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.EngineRequestError = void 0;
4
+ exports.classifyEngineError = classifyEngineError;
5
+ exports.classifyStatus = classifyStatus;
6
+ const UNREACHABLE_CODES = new Set([
7
+ 'ECONNREFUSED',
8
+ 'ENOTFOUND',
9
+ 'EHOSTUNREACH',
10
+ 'ENETUNREACH',
11
+ 'EAI_AGAIN',
12
+ 'ECONNRESET',
13
+ 'UND_ERR_CONNECT_TIMEOUT',
14
+ 'UND_ERR_SOCKET',
15
+ ]);
16
+ const TIMEOUT_CODES = new Set(['ETIMEDOUT', 'UND_ERR_HEADERS_TIMEOUT', 'UND_ERR_BODY_TIMEOUT']);
17
+ /**
18
+ * Map a vendor/transport failure to the SDK's stable taxonomy so callers can
19
+ * react without knowing which vendor produced it.
20
+ */
21
+ function classifyEngineError(error) {
22
+ if (error && typeof error === 'object') {
23
+ const name = error.name;
24
+ if (name === 'AbortError' || name === 'TimeoutError') {
25
+ return 'timeout';
26
+ }
27
+ const status = error.status;
28
+ if (typeof status === 'number') {
29
+ return classifyStatus(status);
30
+ }
31
+ const causeCode = error.cause?.code;
32
+ const code = error.code ?? causeCode;
33
+ if (code) {
34
+ if (TIMEOUT_CODES.has(code))
35
+ return 'timeout';
36
+ if (UNREACHABLE_CODES.has(code))
37
+ return 'unreachable';
38
+ }
39
+ const message = typeof error.message === 'string'
40
+ ? error.message.toLowerCase()
41
+ : '';
42
+ if (message.includes('abort') || message.includes('timeout'))
43
+ return 'timeout';
44
+ if (message.includes('fetch failed') || message.includes('network'))
45
+ return 'unreachable';
46
+ }
47
+ return 'unknown';
48
+ }
49
+ /** Map an HTTP status code to the taxonomy. */
50
+ function classifyStatus(status) {
51
+ if (status === 401 || status === 403)
52
+ return 'auth';
53
+ if (status === 429)
54
+ return 'rate_limited';
55
+ if (status >= 400 && status < 500)
56
+ return 'bad_request';
57
+ if (status >= 500)
58
+ return 'server';
59
+ return 'unknown';
60
+ }
61
+ /** Error thrown by the engine client for non-2xx responses. */
62
+ class EngineRequestError extends Error {
63
+ constructor(status, body) {
64
+ super(`LLM engine request failed (${status})`);
65
+ this.name = 'EngineRequestError';
66
+ this.status = status;
67
+ this.category = classifyStatus(status);
68
+ this.body = body;
69
+ }
70
+ }
71
+ exports.EngineRequestError = EngineRequestError;
72
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/llm-engines/errors.ts"],"names":[],"mappings":";;;AAmBA,kDA0BC;AAGD,wCAMC;AApDD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAC9B,cAAc;IACd,WAAW;IACX,cAAc;IACd,aAAa;IACb,WAAW;IACX,YAAY;IACZ,yBAAyB;IACzB,gBAAgB;CACnB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,yBAAyB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAEhG;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAC9C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,CAAC;QAC/C,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YACnD,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAI,KAA6B,CAAC,MAAM,CAAC;QACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,SAAS,GAAI,KAAuC,CAAC,KAAK,EAAE,IAAI,CAAC;QACvE,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,IAAI,SAAS,CAAC;QAC5D,IAAI,IAAI,EAAE,CAAC;YACP,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC9C,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,aAAa,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAG,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ;YACxE,CAAC,CAAE,KAA6B,CAAC,OAAO,CAAC,WAAW,EAAE;YACtD,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/E,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,aAAa,CAAC;IAC9F,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,+CAA+C;AAC/C,SAAgB,cAAc,CAAC,MAAc;IACzC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IACpD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,aAAa,CAAC;IACxD,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IACnC,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,+DAA+D;AAC/D,MAAa,kBAAmB,SAAQ,KAAK;IAKzC,YAAY,MAAc,EAAE,IAAY;QACpC,KAAK,CAAC,8BAA8B,MAAM,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAZD,gDAYC"}
@@ -0,0 +1,7 @@
1
+ export * from './types';
2
+ export * from './descriptors';
3
+ export * from './endpoint';
4
+ export * from './errors';
5
+ export * from './adapters';
6
+ export * from './client';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm-engines/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const tslib_1 = require("tslib");
4
+ tslib_1.__exportStar(require("./types"), exports);
5
+ tslib_1.__exportStar(require("./descriptors"), exports);
6
+ tslib_1.__exportStar(require("./endpoint"), exports);
7
+ tslib_1.__exportStar(require("./errors"), exports);
8
+ tslib_1.__exportStar(require("./adapters"), exports);
9
+ tslib_1.__exportStar(require("./client"), exports);
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm-engines/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,wDAA8B;AAC9B,qDAA2B;AAC3B,mDAAyB;AACzB,qDAA2B;AAC3B,mDAAyB"}