mesedi 0.1.0 → 0.6.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/README.md +81 -31
- package/dist/_errorClassesGenerated.d.ts +18 -0
- package/dist/_errorClassesGenerated.d.ts.map +1 -0
- package/dist/_errorClassesGenerated.js +24 -0
- package/dist/_errorClassesGenerated.js.map +1 -0
- package/dist/anthropic_integration.d.ts +9 -9
- package/dist/anthropic_integration.d.ts.map +1 -1
- package/dist/anthropic_integration.js +67 -26
- package/dist/anthropic_integration.js.map +1 -1
- package/dist/client.d.ts +32 -12
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +46 -18
- package/dist/client.js.map +1 -1
- package/dist/cohere_integration.d.ts +42 -0
- package/dist/cohere_integration.d.ts.map +1 -0
- package/dist/cohere_integration.js +456 -0
- package/dist/cohere_integration.js.map +1 -0
- package/dist/compress.d.ts +69 -0
- package/dist/compress.d.ts.map +1 -0
- package/dist/compress.js +75 -0
- package/dist/compress.js.map +1 -0
- package/dist/context.d.ts +13 -4
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +15 -5
- package/dist/context.js.map +1 -1
- package/dist/errors.d.ts +137 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +462 -0
- package/dist/errors.js.map +1 -0
- package/dist/events.d.ts +19 -6
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js +31 -6
- package/dist/events.js.map +1 -1
- package/dist/gemini_integration.d.ts +33 -0
- package/dist/gemini_integration.d.ts.map +1 -0
- package/dist/gemini_integration.js +334 -0
- package/dist/gemini_integration.js.map +1 -0
- package/dist/halt.d.ts +12 -12
- package/dist/halt.js +16 -16
- package/dist/halt.js.map +1 -1
- package/dist/halt_stream.d.ts +6 -6
- package/dist/halt_stream.d.ts.map +1 -1
- package/dist/halt_stream.js +22 -12
- package/dist/halt_stream.js.map +1 -1
- package/dist/index.d.ts +26 -13
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +20 -12
- package/dist/index.js.map +1 -1
- package/dist/integrations/langgraph.d.ts +99 -0
- package/dist/integrations/langgraph.d.ts.map +1 -0
- package/dist/integrations/langgraph.js +572 -0
- package/dist/integrations/langgraph.js.map +1 -0
- package/dist/integrations/mastra.d.ts +114 -0
- package/dist/integrations/mastra.d.ts.map +1 -0
- package/dist/integrations/mastra.js +354 -0
- package/dist/integrations/mastra.js.map +1 -0
- package/dist/integrations/openai_agents.d.ts +66 -0
- package/dist/integrations/openai_agents.d.ts.map +1 -0
- package/dist/integrations/openai_agents.js +243 -0
- package/dist/integrations/openai_agents.js.map +1 -0
- package/dist/integrations/promptfoo.d.ts +62 -0
- package/dist/integrations/promptfoo.d.ts.map +1 -0
- package/dist/integrations/promptfoo.js +76 -0
- package/dist/integrations/promptfoo.js.map +1 -0
- package/dist/integrations/ragas.d.ts +65 -0
- package/dist/integrations/ragas.d.ts.map +1 -0
- package/dist/integrations/ragas.js +78 -0
- package/dist/integrations/ragas.js.map +1 -0
- package/dist/integrations/vectara.d.ts +60 -0
- package/dist/integrations/vectara.d.ts.map +1 -0
- package/dist/integrations/vectara.js +59 -0
- package/dist/integrations/vectara.js.map +1 -0
- package/dist/integrations/vercel_ai.d.ts +6 -6
- package/dist/integrations/vercel_ai.js +10 -10
- package/dist/integrations/vercel_ai.js.map +1 -1
- package/dist/observe.d.ts +358 -3
- package/dist/observe.d.ts.map +1 -1
- package/dist/observe.js +536 -4
- package/dist/observe.js.map +1 -1
- package/dist/ollama_integration.d.ts +126 -0
- package/dist/ollama_integration.d.ts.map +1 -0
- package/dist/ollama_integration.js +404 -0
- package/dist/ollama_integration.js.map +1 -0
- package/dist/openai_integration.d.ts +67 -0
- package/dist/openai_integration.d.ts.map +1 -0
- package/dist/openai_integration.js +574 -0
- package/dist/openai_integration.js.map +1 -0
- package/dist/tool.d.ts +1 -1
- package/dist/tool.d.ts.map +1 -1
- package/dist/tool.js +193 -10
- package/dist/tool.js.map +1 -1
- package/dist/truncate.d.ts +84 -0
- package/dist/truncate.d.ts.map +1 -0
- package/dist/truncate.js +134 -0
- package/dist/truncate.js.map +1 -0
- package/dist/vertex_gemini_integration.d.ts +27 -0
- package/dist/vertex_gemini_integration.d.ts.map +1 -0
- package/dist/vertex_gemini_integration.js +229 -0
- package/dist/vertex_gemini_integration.js.map +1 -0
- package/dist/wrap.d.ts +39 -3
- package/dist/wrap.d.ts.map +1 -1
- package/dist/wrap.js +15 -12
- package/dist/wrap.js.map +1 -1
- package/package.json +28 -4
package/dist/client.js
CHANGED
|
@@ -1,23 +1,36 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* MesediClient
|
|
2
|
+
* MesediClient, HTTP client + async event shipper for Node.
|
|
3
3
|
*
|
|
4
|
-
* Zero runtime dependencies: uses Node 18+ native `fetch` for HTTP
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
4
|
+
* Zero runtime dependencies: uses Node 18+ native `fetch` for HTTP,
|
|
5
|
+
* `AsyncLocalStorage` for async context (in wrap()/tool()), and
|
|
6
|
+
* `node:zlib` for opt-in gzip compression of request bodies above 1
|
|
7
|
+
* KB. Below the threshold requests ship uncompressed exactly as
|
|
8
|
+
* v0.2.0 did. No background threads (Node doesn't have them in the
|
|
9
|
+
* Python sense); instead a `setInterval` timer drains the queue
|
|
10
|
+
* periodically, and a `process.on("exit")` handler flushes any
|
|
11
|
+
* remaining items at shutdown.
|
|
12
|
+
*
|
|
13
|
+
* Why gzip (and why the Python SDK uses zstd): JavaScript zstd
|
|
14
|
+
* encoders are heavy (WASM, ~750 KB, async init) and would break
|
|
15
|
+
* this SDK's tiny-install posture. Node ships gzip synchronously in
|
|
16
|
+
* its standard library, so gzip lets us compress with no new
|
|
17
|
+
* dependency and zero install-size cost. The backend accepts both
|
|
18
|
+
* encodings through the same middleware path.
|
|
9
19
|
*
|
|
10
20
|
* Auth: bearer token (`mesedi_sk_...`). Wire-format version pinned
|
|
11
21
|
* at "1" today; future breaking changes bump SCHEMA_VERSION and the
|
|
12
22
|
* backend tightens enforcement.
|
|
13
23
|
*
|
|
14
24
|
* Fail-open: every observation HTTP call wraps its promise in a
|
|
15
|
-
* try/catch
|
|
25
|
+
* try/catch, backend errors are logged via console.warn (configurable
|
|
16
26
|
* via a logger injection in a future polish slice) but NEVER bubble
|
|
17
|
-
* back to the wrapped agent code.
|
|
27
|
+
* back to the wrapped agent code. Compression also fails open: if
|
|
28
|
+
* the encoder throws, the body ships uncompressed instead.
|
|
18
29
|
*/
|
|
30
|
+
import { maybeCompress } from "./compress.js";
|
|
31
|
+
import { DEFAULT_MAX_PAYLOAD_BYTES, maybeTruncate } from "./truncate.js";
|
|
19
32
|
import { eventToWire, executionEndPayload, executionStartPayload, } from "./events.js";
|
|
20
|
-
export const DEFAULT_BASE_URL = "
|
|
33
|
+
export const DEFAULT_BASE_URL = "https://api.mesedi.ai";
|
|
21
34
|
export const DEFAULT_TIMEOUT_MS = 10_000;
|
|
22
35
|
export const SCHEMA_VERSION = "1";
|
|
23
36
|
export class MesediClient {
|
|
@@ -27,6 +40,7 @@ export class MesediClient {
|
|
|
27
40
|
flushIntervalMs;
|
|
28
41
|
batchSize;
|
|
29
42
|
maxQueue;
|
|
43
|
+
maxPayloadBytes;
|
|
30
44
|
queue = [];
|
|
31
45
|
pendingEvents = [];
|
|
32
46
|
lastFlush = Date.now();
|
|
@@ -40,7 +54,7 @@ export class MesediClient {
|
|
|
40
54
|
throw new Error("Mesedi API key not provided. Pass { apiKey: '...' } or set MESEDI_API_KEY in the environment.");
|
|
41
55
|
}
|
|
42
56
|
if (!apiKey.startsWith("mesedi_sk_")) {
|
|
43
|
-
// Mirror the backend's auth-middleware check
|
|
57
|
+
// Mirror the backend's auth-middleware check, fail loudly on
|
|
44
58
|
// the SDK side rather than letting the backend return 401 on
|
|
45
59
|
// every call.
|
|
46
60
|
throw new Error("api_key must start with 'mesedi_sk_' (received an obviously-malformed key)");
|
|
@@ -51,8 +65,9 @@ export class MesediClient {
|
|
|
51
65
|
this.flushIntervalMs = opts.flushIntervalMs ?? 250;
|
|
52
66
|
this.batchSize = opts.batchSize ?? 100;
|
|
53
67
|
this.maxQueue = opts.maxQueue ?? 10_000;
|
|
68
|
+
this.maxPayloadBytes = opts.maxPayloadBytes ?? DEFAULT_MAX_PAYLOAD_BYTES;
|
|
54
69
|
// Start the periodic flush timer. unref() so it doesn't keep the
|
|
55
|
-
// event loop alive on its own
|
|
70
|
+
// event loop alive on its own, the process can exit when the
|
|
56
71
|
// user's code is done, and our atexit handler drains anything left.
|
|
57
72
|
this.timer = setInterval(() => this.tick(), this.flushIntervalMs);
|
|
58
73
|
this.timer.unref();
|
|
@@ -67,6 +82,14 @@ export class MesediClient {
|
|
|
67
82
|
this.enqueue({ kind: "update_execution", body: execution });
|
|
68
83
|
}
|
|
69
84
|
submitEvent(event) {
|
|
85
|
+
// Apply the per-event payload cap (#243) BEFORE the event enters
|
|
86
|
+
// the queue. Truncating here keeps the queue's memory footprint
|
|
87
|
+
// bounded even when a customer accidentally captures a multi-MB
|
|
88
|
+
// blob; downstream retries reuse the already-trimmed payload
|
|
89
|
+
// instead of re-running truncation on every attempt.
|
|
90
|
+
if (this.maxPayloadBytes > 0) {
|
|
91
|
+
event.payload = maybeTruncate(event.payload, this.maxPayloadBytes);
|
|
92
|
+
}
|
|
70
93
|
this.enqueue({ kind: "event", body: event });
|
|
71
94
|
}
|
|
72
95
|
/**
|
|
@@ -105,7 +128,7 @@ export class MesediClient {
|
|
|
105
128
|
if (this.stopped) {
|
|
106
129
|
// Even after shutdown is invoked, the user's main code might
|
|
107
130
|
// continue running for a short tick. Best-effort: drop silently
|
|
108
|
-
// rather than throw
|
|
131
|
+
// rather than throw, we're already past the contractual
|
|
109
132
|
// observation window.
|
|
110
133
|
return;
|
|
111
134
|
}
|
|
@@ -119,7 +142,7 @@ export class MesediClient {
|
|
|
119
142
|
this.queue.push(item);
|
|
120
143
|
}
|
|
121
144
|
/**
|
|
122
|
-
* Single tick of the shipper loop
|
|
145
|
+
* Single tick of the shipper loop, called by setInterval. Drains
|
|
123
146
|
* the queue, dispatches non-event items, and flushes the pending-
|
|
124
147
|
* events batch if it's full OR the flush interval has elapsed.
|
|
125
148
|
*/
|
|
@@ -127,7 +150,7 @@ export class MesediClient {
|
|
|
127
150
|
if (this.queue.length === 0 && this.pendingEvents.length === 0)
|
|
128
151
|
return;
|
|
129
152
|
// Chain onto the previous tick's promise so we serialize HTTP
|
|
130
|
-
// calls
|
|
153
|
+
// calls, preserves ordering (POST /executions before PATCH for
|
|
131
154
|
// the same execution).
|
|
132
155
|
this.inflight = this.inflight.then(() => this.processOnce());
|
|
133
156
|
await this.inflight;
|
|
@@ -142,7 +165,7 @@ export class MesediClient {
|
|
|
142
165
|
}
|
|
143
166
|
}
|
|
144
167
|
else {
|
|
145
|
-
// Non-event item
|
|
168
|
+
// Non-event item, flush pending events first so the PATCH
|
|
146
169
|
// doesn't arrive before its preceding /events POST.
|
|
147
170
|
if (this.pendingEvents.length > 0) {
|
|
148
171
|
await this.flushPendingEvents();
|
|
@@ -181,10 +204,14 @@ export class MesediClient {
|
|
|
181
204
|
}
|
|
182
205
|
/**
|
|
183
206
|
* One HTTP call with up to 3 retries on transient failure
|
|
184
|
-
* (network errors, 5xx). 4xx responses drop with a warning
|
|
207
|
+
* (network errors, 5xx). 4xx responses drop with a warning, the
|
|
185
208
|
* request is malformed and retrying won't help.
|
|
186
209
|
*/
|
|
187
210
|
async sendWithRetry(method, path, body, description) {
|
|
211
|
+
// Serialize once, outside the retry loop, so retries do not
|
|
212
|
+
// repeat the JSON.stringify or compression cost.
|
|
213
|
+
const rawBody = new TextEncoder().encode(JSON.stringify(body));
|
|
214
|
+
const { body: finalBody, extraHeaders } = maybeCompress(rawBody);
|
|
188
215
|
const backoffs = [100, 500, 2000];
|
|
189
216
|
let lastErr = null;
|
|
190
217
|
for (let attempt = 0; attempt <= backoffs.length; attempt++) {
|
|
@@ -197,15 +224,16 @@ export class MesediClient {
|
|
|
197
224
|
Authorization: `Bearer ${this.apiKey}`,
|
|
198
225
|
"Content-Type": "application/json",
|
|
199
226
|
"X-Mesedi-Schema-Version": SCHEMA_VERSION,
|
|
227
|
+
...extraHeaders,
|
|
200
228
|
},
|
|
201
|
-
body:
|
|
229
|
+
body: finalBody,
|
|
202
230
|
signal: controller.signal,
|
|
203
231
|
});
|
|
204
232
|
clearTimeout(timer);
|
|
205
233
|
if (resp.status < 400)
|
|
206
234
|
return; // success
|
|
207
235
|
if (resp.status >= 400 && resp.status < 500) {
|
|
208
|
-
// Permanent failure
|
|
236
|
+
// Permanent failure, retrying won't help.
|
|
209
237
|
const text = await resp.text().catch(() => "");
|
|
210
238
|
console.warn(`mesedi: ${description} rejected with ${resp.status}: ${text.slice(0, 200)}`);
|
|
211
239
|
return;
|
package/dist/client.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cohere TypeScript SDK monkey-patch — auto-emit llm_call events
|
|
3
|
+
* for every chat call inside a wrap()'d execution.
|
|
4
|
+
*
|
|
5
|
+
* Mirrors instrumentAnthropic / instrumentOpenAI in fail-open
|
|
6
|
+
* semantics, canonical error vocabulary, idempotency. Patches:
|
|
7
|
+
*
|
|
8
|
+
* - cohere-ai CohereClient.chat (v1 surface, `message=` shape)
|
|
9
|
+
* - cohere-ai CohereClientV2.chat (v7+ OpenAI-style `messages=`)
|
|
10
|
+
*
|
|
11
|
+
* Both write the same canonical llm_call payload
|
|
12
|
+
* (provider="cohere") so the backend doesn't need to know which
|
|
13
|
+
* API surface fired.
|
|
14
|
+
*
|
|
15
|
+
* Dependency injection: instrumentCohere accepts optional
|
|
16
|
+
* v1Class + v2Class arguments so this code path is testable
|
|
17
|
+
* without installing cohere-ai.
|
|
18
|
+
*/
|
|
19
|
+
export interface CohereClientLike {
|
|
20
|
+
prototype: {
|
|
21
|
+
chat: (...args: any[]) => Promise<any>;
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
/** Patch the Cohere SDK chat surfaces (v1 + v2). Returns true if at
|
|
25
|
+
* least one was patched. False if neither could be located AND the
|
|
26
|
+
* cohere-ai package isn't installed. */
|
|
27
|
+
export declare function instrumentCohere(v1Class?: CohereClientLike, v2Class?: CohereClientLike): Promise<boolean>;
|
|
28
|
+
export interface CohereEmbedClassLike {
|
|
29
|
+
prototype: {
|
|
30
|
+
embed: (...args: any[]) => Promise<any>;
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
export interface CohereRerankClassLike {
|
|
34
|
+
prototype: {
|
|
35
|
+
rerank: (...args: any[]) => Promise<any>;
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
declare function patchEmbedSync(cls: CohereEmbedClassLike): void;
|
|
39
|
+
declare function patchRerankSync(cls: CohereRerankClassLike): void;
|
|
40
|
+
export { patchEmbedSync as patchEmbedV1, patchEmbedSync as patchEmbedV2 };
|
|
41
|
+
export { patchRerankSync as patchRerankV1, patchRerankSync as patchRerankV2 };
|
|
42
|
+
//# sourceMappingURL=cohere_integration.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cohere_integration.d.ts","sourceRoot":"","sources":["../src/cohere_integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqBH,MAAM,WAAW,gBAAgB;IAE/B,SAAS,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACvD;AASD;;wCAEwC;AACxC,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,OAAO,CAAC,CAiClB;AAuRD,MAAM,WAAW,oBAAoB;IAEnC,SAAS,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACxD;AACD,MAAM,WAAW,qBAAqB;IAEpC,SAAS,EAAE;QAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACzD;AA6CD,iBAAS,cAAc,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI,CAwEvD;AAED,iBAAS,eAAe,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAuEzD;AAED,OAAO,EAAE,cAAc,IAAI,YAAY,EAAE,cAAc,IAAI,YAAY,EAAE,CAAC;AAC1E,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,eAAe,IAAI,aAAa,EAAE,CAAC"}
|