@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.
- package/LICENSE +21 -0
- package/README.md +57 -0
- package/dist/core/http-client.d.ts +84 -0
- package/dist/core/http-client.d.ts.map +1 -0
- package/dist/core/http-client.js +177 -0
- package/dist/core/http-client.js.map +1 -0
- package/dist/core/index.d.ts +3 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +7 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/rate-limiter.d.ts +40 -0
- package/dist/core/rate-limiter.d.ts.map +1 -0
- package/dist/core/rate-limiter.js +65 -0
- package/dist/core/rate-limiter.js.map +1 -0
- package/dist/generated/api-types.d.ts +1742 -0
- package/dist/generated/api-types.d.ts.map +1 -0
- package/dist/generated/api-types.js +7 -0
- package/dist/generated/api-types.js.map +1 -0
- package/dist/index.d.ts +92 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +129 -0
- package/dist/index.js.map +1 -0
- package/dist/llm-engines/adapters.d.ts +26 -0
- package/dist/llm-engines/adapters.d.ts.map +1 -0
- package/dist/llm-engines/adapters.js +121 -0
- package/dist/llm-engines/adapters.js.map +1 -0
- package/dist/llm-engines/client.d.ts +12 -0
- package/dist/llm-engines/client.d.ts.map +1 -0
- package/dist/llm-engines/client.js +138 -0
- package/dist/llm-engines/client.js.map +1 -0
- package/dist/llm-engines/descriptors.d.ts +24 -0
- package/dist/llm-engines/descriptors.d.ts.map +1 -0
- package/dist/llm-engines/descriptors.js +192 -0
- package/dist/llm-engines/descriptors.js.map +1 -0
- package/dist/llm-engines/endpoint.d.ts +5 -0
- package/dist/llm-engines/endpoint.d.ts.map +1 -0
- package/dist/llm-engines/endpoint.js +19 -0
- package/dist/llm-engines/endpoint.js.map +1 -0
- package/dist/llm-engines/errors.d.ts +16 -0
- package/dist/llm-engines/errors.d.ts.map +1 -0
- package/dist/llm-engines/errors.js +72 -0
- package/dist/llm-engines/errors.js.map +1 -0
- package/dist/llm-engines/index.d.ts +7 -0
- package/dist/llm-engines/index.d.ts.map +1 -0
- package/dist/llm-engines/index.js +10 -0
- package/dist/llm-engines/index.js.map +1 -0
- package/dist/llm-engines/types.d.ts +130 -0
- package/dist/llm-engines/types.d.ts.map +1 -0
- package/dist/llm-engines/types.js +32 -0
- package/dist/llm-engines/types.js.map +1 -0
- package/dist/mcp/host.d.ts +13 -0
- package/dist/mcp/host.d.ts.map +1 -0
- package/dist/mcp/host.js +72 -0
- package/dist/mcp/host.js.map +1 -0
- package/dist/mcp/index.d.ts +4 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +7 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/mcp.service.d.ts +21 -0
- package/dist/mcp/mcp.service.d.ts.map +1 -0
- package/dist/mcp/mcp.service.js +35 -0
- package/dist/mcp/mcp.service.js.map +1 -0
- package/dist/mcp/types.d.ts +60 -0
- package/dist/mcp/types.d.ts.map +1 -0
- package/dist/mcp/types.js +7 -0
- package/dist/mcp/types.js.map +1 -0
- package/dist/models/agent.model.d.ts +62 -0
- package/dist/models/agent.model.d.ts.map +1 -0
- package/dist/models/agent.model.js +3 -0
- package/dist/models/agent.model.js.map +1 -0
- package/dist/models/ai-chat.model.d.ts +27 -0
- package/dist/models/ai-chat.model.d.ts.map +1 -0
- package/dist/models/ai-chat.model.js +3 -0
- package/dist/models/ai-chat.model.js.map +1 -0
- package/dist/models/api-error.model.d.ts +33 -0
- package/dist/models/api-error.model.d.ts.map +1 -0
- package/dist/models/api-error.model.js +59 -0
- package/dist/models/api-error.model.js.map +1 -0
- package/dist/models/api-response.model.d.ts +52 -0
- package/dist/models/api-response.model.d.ts.map +1 -0
- package/dist/models/api-response.model.js +78 -0
- package/dist/models/api-response.model.js.map +1 -0
- package/dist/models/auth.model.d.ts +25 -0
- package/dist/models/auth.model.d.ts.map +1 -0
- package/dist/models/auth.model.js +6 -0
- package/dist/models/auth.model.js.map +1 -0
- package/dist/models/backup.model.d.ts +34 -0
- package/dist/models/backup.model.d.ts.map +1 -0
- package/dist/models/backup.model.js +3 -0
- package/dist/models/backup.model.js.map +1 -0
- package/dist/models/chat.model.d.ts +87 -0
- package/dist/models/chat.model.d.ts.map +1 -0
- package/dist/models/chat.model.js +7 -0
- package/dist/models/chat.model.js.map +1 -0
- package/dist/models/file.model.d.ts +50 -0
- package/dist/models/file.model.d.ts.map +1 -0
- package/dist/models/file.model.js +7 -0
- package/dist/models/file.model.js.map +1 -0
- package/dist/models/index.d.ts +17 -0
- package/dist/models/index.d.ts.map +1 -0
- package/dist/models/index.js +20 -0
- package/dist/models/index.js.map +1 -0
- package/dist/models/knowledge.model.d.ts +63 -0
- package/dist/models/knowledge.model.d.ts.map +1 -0
- package/dist/models/knowledge.model.js +3 -0
- package/dist/models/knowledge.model.js.map +1 -0
- package/dist/models/llm-engine.model.d.ts +25 -0
- package/dist/models/llm-engine.model.d.ts.map +1 -0
- package/dist/models/llm-engine.model.js +3 -0
- package/dist/models/llm-engine.model.js.map +1 -0
- package/dist/models/prompt.model.d.ts +30 -0
- package/dist/models/prompt.model.d.ts.map +1 -0
- package/dist/models/prompt.model.js +3 -0
- package/dist/models/prompt.model.js.map +1 -0
- package/dist/models/role.model.d.ts +19 -0
- package/dist/models/role.model.d.ts.map +1 -0
- package/dist/models/role.model.js +3 -0
- package/dist/models/role.model.js.map +1 -0
- package/dist/models/streaming.model.d.ts +27 -0
- package/dist/models/streaming.model.d.ts.map +1 -0
- package/dist/models/streaming.model.js +3 -0
- package/dist/models/streaming.model.js.map +1 -0
- package/dist/models/update.model.d.ts +16 -0
- package/dist/models/update.model.d.ts.map +1 -0
- package/dist/models/update.model.js +3 -0
- package/dist/models/update.model.js.map +1 -0
- package/dist/models/usb-patch.model.d.ts +13 -0
- package/dist/models/usb-patch.model.d.ts.map +1 -0
- package/dist/models/usb-patch.model.js +3 -0
- package/dist/models/usb-patch.model.js.map +1 -0
- package/dist/models/user.model.d.ts +64 -0
- package/dist/models/user.model.d.ts.map +1 -0
- package/dist/models/user.model.js +3 -0
- package/dist/models/user.model.js.map +1 -0
- package/dist/services/agent.service.d.ts +45 -0
- package/dist/services/agent.service.d.ts.map +1 -0
- package/dist/services/agent.service.js +91 -0
- package/dist/services/agent.service.js.map +1 -0
- package/dist/services/ai-chat.service.d.ts +12 -0
- package/dist/services/ai-chat.service.d.ts.map +1 -0
- package/dist/services/ai-chat.service.js +116 -0
- package/dist/services/ai-chat.service.js.map +1 -0
- package/dist/services/auth.service.d.ts +25 -0
- package/dist/services/auth.service.d.ts.map +1 -0
- package/dist/services/auth.service.js +76 -0
- package/dist/services/auth.service.js.map +1 -0
- package/dist/services/chat.service.d.ts +90 -0
- package/dist/services/chat.service.d.ts.map +1 -0
- package/dist/services/chat.service.js +240 -0
- package/dist/services/chat.service.js.map +1 -0
- package/dist/services/index.d.ts +12 -0
- package/dist/services/index.d.ts.map +1 -0
- package/dist/services/index.js +16 -0
- package/dist/services/index.js.map +1 -0
- package/dist/services/knowledge.service.d.ts +18 -0
- package/dist/services/knowledge.service.d.ts.map +1 -0
- package/dist/services/knowledge.service.js +33 -0
- package/dist/services/knowledge.service.js.map +1 -0
- package/dist/services/llm-engines.service.d.ts +12 -0
- package/dist/services/llm-engines.service.d.ts.map +1 -0
- package/dist/services/llm-engines.service.js +26 -0
- package/dist/services/llm-engines.service.js.map +1 -0
- package/dist/services/prompts.service.d.ts +16 -0
- package/dist/services/prompts.service.d.ts.map +1 -0
- package/dist/services/prompts.service.js +31 -0
- package/dist/services/prompts.service.js.map +1 -0
- package/dist/services/role.service.d.ts +12 -0
- package/dist/services/role.service.d.ts.map +1 -0
- package/dist/services/role.service.js +29 -0
- package/dist/services/role.service.js.map +1 -0
- package/dist/services/streaming.service.d.ts +18 -0
- package/dist/services/streaming.service.d.ts.map +1 -0
- package/dist/services/streaming.service.js +103 -0
- package/dist/services/streaming.service.js.map +1 -0
- package/dist/services/usb-patches.service.d.ts +9 -0
- package/dist/services/usb-patches.service.d.ts.map +1 -0
- package/dist/services/usb-patches.service.js +16 -0
- package/dist/services/usb-patches.service.js.map +1 -0
- package/dist/services/user.service.d.ts +15 -0
- package/dist/services/user.service.d.ts.map +1 -0
- package/dist/services/user.service.js +40 -0
- package/dist/services/user.service.js.map +1 -0
- 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":";;AAkBA,0CAYC;AAGD,gCAqBC;AAWD,gDAsFC;AAvJD,yCAAyI;AACzI,+CAAoD;AACpD,qCAAmF;AAenF,2EAA2E;AAC3E,SAAgB,eAAe,CAAC,UAAgC,EAAE,IAAY;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,IAAA,yBAAc,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,iFAAiF;AAC1E,KAAK,SAAS,CAAC,CAAC,UAAU,CAC7B,QAA6B,EAC7B,UAAgC;IAEhC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,SAAS,CAAC;QACN,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAY,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC/C,IAAI,IAAI;gBAAE,MAAM,IAAI,CAAC;QACzB,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,IAAI;QAAE,MAAM,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,YAAY;IACjB,OAAO,UAAU,CAAC,KAA+B,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,MAAoB,EAAE,OAAyB,EAAE;IAChF,MAAM,QAAQ,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,EAAE,CAAC;IAE/C,MAAM,IAAI,GAAG,CAAC,OAAwF,EAAE,MAAoB,EAAE,EAAE,CAC5H,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;QAC7D,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,KAAK,EAAE,QAA6B,EAAmB,EAAE;QACtE,IAAI,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,EAAE,QAA6B,EAAiB,EAAE;QACrE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,2BAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACH,MAAM,EAAE;YACJ,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1D;QAED,KAAK,CAAC,IAAI,CAAC,QAAyB,EAAE,UAAuB,EAAE;YAC3D,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACpF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAAA,4BAAiB,EAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,KAAK,CAAC,CAAC,UAAU,CAAC,QAAyB,EAAE,UAAuB,EAAE;YAClE,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1B,KAAK,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrD,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,KAAe;YACvB,MAAM,OAAO,GAAG,IAAA,4BAAiB,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,EAAE,UAAU,EAAE,IAAA,0BAAe,EAAC,IAAI,CAAC,EAAE,CAAC;QACjD,CAAC;QAED,KAAK,CAAC,MAAM;YACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACD,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAA,6BAAkB,EAAC,QAAQ,CAAC,CAAC,CAAC;gBACxD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;oBACpF,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAA,6BAAkB,EAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC;gBAChG,CAAC;gBACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACzC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC5D,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACtD,OAAO;oBACH,EAAE,EAAE,KAAK;oBACT,SAAS;oBACT,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,QAAQ,EAAE,IAAA,uBAAc,EAAC,QAAQ,CAAC,MAAM,CAAC;oBACzC,KAAK,EAAE,IAAI,IAAI,QAAQ,QAAQ,CAAC,MAAM,EAAE;iBAC3C,CAAC;YACN,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO;oBACH,EAAE,EAAE,KAAK;oBACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBACjC,QAAQ,EAAE,IAAA,4BAAmB,EAAC,KAAK,CAAC;oBACpC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAChE,CAAC;YACN,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC"}
|
|
@@ -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 @@
|
|
|
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"}
|