mesedi 0.2.0 → 0.7.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 +57 -5
- 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.map +1 -1
- package/dist/anthropic_integration.js +51 -10
- package/dist/anthropic_integration.js.map +1 -1
- package/dist/client.d.ts +26 -6
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +35 -7
- 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 +11 -2
- package/dist/context.d.ts.map +1 -1
- package/dist/context.js +13 -3
- 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 +13 -0
- package/dist/events.d.ts.map +1 -1
- package/dist/events.js +26 -1
- 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_stream.d.ts.map +1 -1
- package/dist/halt_stream.js +11 -1
- package/dist/halt_stream.js.map +1 -1
- package/dist/index.d.ts +15 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/integrations/langchain.d.ts +95 -0
- package/dist/integrations/langchain.d.ts.map +1 -0
- package/dist/integrations/langchain.js +549 -0
- package/dist/integrations/langchain.js.map +1 -0
- 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/observe.d.ts +355 -0
- package/dist/observe.d.ts.map +1 -1
- package/dist/observe.js +532 -0
- 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.map +1 -1
- package/dist/tool.js +189 -6
- 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 +36 -0
- package/dist/wrap.d.ts.map +1 -1
- package/dist/wrap.js +5 -2
- package/dist/wrap.js.map +1 -1
- package/package.json +36 -3
package/README.md
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
# Mesedi TypeScript SDK
|
|
2
2
|
|
|
3
|
-
**Status:** v0.
|
|
3
|
+
**Status:** v0.4.0. Live on npm.
|
|
4
4
|
|
|
5
5
|
The TypeScript companion to `sdk-python/`. Feature parity for the v1
|
|
6
6
|
surface (`configure()`, `wrap()`, `tool()`, async event shipper,
|
|
7
|
-
fail-open posture), built on Node 18+ native `fetch
|
|
8
|
-
`AsyncLocalStorage
|
|
7
|
+
fail-open posture), built on Node 18+ native `fetch`,
|
|
8
|
+
`AsyncLocalStorage`, and `node:zlib` for opt-in gzip compression of
|
|
9
|
+
request bodies above 1 KB. **Zero runtime dependencies.** Compresses
|
|
10
|
+
or not transparently; small calls ship uncompressed as before.
|
|
9
11
|
|
|
10
12
|
## Install
|
|
11
13
|
|
|
@@ -45,7 +47,7 @@ await flush();
|
|
|
45
47
|
For each `wrap()`-decorated call:
|
|
46
48
|
|
|
47
49
|
- **On entry:** `POST /executions` (status=started, sdk_language=typescript,
|
|
48
|
-
sdk_version=0.0
|
|
50
|
+
sdk_version=0.4.0).
|
|
49
51
|
- **On normal return:** `PATCH /executions/{id}` (status=completed,
|
|
50
52
|
duration_ms, ended_at).
|
|
51
53
|
- **On thrown error:** `PATCH /executions/{id}` (status=crashed,
|
|
@@ -65,6 +67,54 @@ invisibility, not to broken production code.
|
|
|
65
67
|
|
|
66
68
|
## Framework integrations
|
|
67
69
|
|
|
70
|
+
Adapter modules under `mesedi/integrations/*` translate each framework's
|
|
71
|
+
native callback or hook surface into Mesedi telemetry. They're optional;
|
|
72
|
+
importing `mesedi` itself never requires any framework to be installed.
|
|
73
|
+
|
|
74
|
+
Currently shipping: **LangGraph**, **OpenAI Agents SDK**, and **Vercel AI
|
|
75
|
+
SDK**. Each peer dependency is opt-in.
|
|
76
|
+
|
|
77
|
+
### LangGraph
|
|
78
|
+
|
|
79
|
+
```typescript
|
|
80
|
+
import { configure, wrap } from "mesedi";
|
|
81
|
+
import { instrumentGraph } from "mesedi/integrations/langgraph";
|
|
82
|
+
|
|
83
|
+
configure({ apiKey: process.env.MESEDI_API_KEY! });
|
|
84
|
+
|
|
85
|
+
export const runMyGraph = wrap(async (question: string) => {
|
|
86
|
+
const graph = buildGraph();
|
|
87
|
+
instrumentGraph(graph);
|
|
88
|
+
const result = await graph.invoke({ input: question });
|
|
89
|
+
return result.output;
|
|
90
|
+
});
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`instrumentGraph` attaches Mesedi telemetry to each node in the graph
|
|
94
|
+
and emits `llm_call` and `tool_call` events labeled with the node name,
|
|
95
|
+
so the dashboard timeline shows the graph's flow alongside per-step
|
|
96
|
+
detail.
|
|
97
|
+
|
|
98
|
+
### OpenAI Agents SDK
|
|
99
|
+
|
|
100
|
+
```typescript
|
|
101
|
+
import { configure, wrap } from "mesedi";
|
|
102
|
+
import { instrumentAgent } from "mesedi/integrations/openai_agents";
|
|
103
|
+
|
|
104
|
+
configure({ apiKey: process.env.MESEDI_API_KEY! });
|
|
105
|
+
|
|
106
|
+
export const runMyAgent = wrap(async (question: string) => {
|
|
107
|
+
const agent = buildAgent();
|
|
108
|
+
instrumentAgent(agent);
|
|
109
|
+
return agent.run(question);
|
|
110
|
+
});
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
`instrumentAgent` subscribes to the OpenAI Agents SDK's lifecycle hooks
|
|
114
|
+
and emits `llm_call` + `tool_call` events with the same wire format as
|
|
115
|
+
the LangGraph and Vercel AI SDK adapters, so detectors see no
|
|
116
|
+
difference.
|
|
117
|
+
|
|
68
118
|
### Vercel AI SDK
|
|
69
119
|
|
|
70
120
|
If your agent uses Vercel's `ai` package (`generateText`, multi-step
|
|
@@ -116,7 +166,9 @@ hand-written `mesedi` instrumentation produces.
|
|
|
116
166
|
`mesedi` doesn't require it. If your project already has `ai`
|
|
117
167
|
installed for `generateText`, the integration just works.
|
|
118
168
|
|
|
119
|
-
`streamText` and `generateObject`
|
|
169
|
+
Only `generateText` is wrapped today. `streamText` and `generateObject`
|
|
170
|
+
are not currently supported; use hand-instrumentation with
|
|
171
|
+
`emitLLMCall` / `tool()` for those code paths.
|
|
120
172
|
|
|
121
173
|
## Releases
|
|
122
174
|
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AUTO-GENERATED by scripts/codegen.py from spec/error_classes.yaml. DO NOT EDIT BY HAND. Re-run codegen after editing the spec.
|
|
3
|
+
*/
|
|
4
|
+
/** Canonical ErrorClass constants (wire-format values). */
|
|
5
|
+
export declare const ERROR_CLASS_NAMES: {
|
|
6
|
+
readonly RATE_LIMITED: "rate_limited";
|
|
7
|
+
readonly QUOTA_EXHAUSTED: "quota_exhausted";
|
|
8
|
+
readonly INTERNAL_ERROR: "internal_error";
|
|
9
|
+
readonly SERVICE_UNAVAILABLE: "service_unavailable";
|
|
10
|
+
readonly TIMEOUT: "timeout";
|
|
11
|
+
readonly INVALID_API_KEY: "invalid_api_key";
|
|
12
|
+
readonly CLIENT_ERROR: "client_error";
|
|
13
|
+
readonly UNKNOWN: "unknown";
|
|
14
|
+
};
|
|
15
|
+
/** Subset of ErrorClass values that count as 'provider-side' for
|
|
16
|
+
* the provider_incident detector. */
|
|
17
|
+
export declare const PROVIDER_SIDE_ERROR_CLASS_VALUES: ReadonlySet<string>;
|
|
18
|
+
//# sourceMappingURL=_errorClassesGenerated.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_errorClassesGenerated.d.ts","sourceRoot":"","sources":["../src/_errorClassesGenerated.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX;qCACqC;AACrC,eAAO,MAAM,gCAAgC,EAAE,WAAW,CAAC,MAAM,CAM/D,CAAC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AUTO-GENERATED by scripts/codegen.py from spec/error_classes.yaml. DO NOT EDIT BY HAND. Re-run codegen after editing the spec.
|
|
3
|
+
*/
|
|
4
|
+
/** Canonical ErrorClass constants (wire-format values). */
|
|
5
|
+
export const ERROR_CLASS_NAMES = {
|
|
6
|
+
RATE_LIMITED: "rate_limited",
|
|
7
|
+
QUOTA_EXHAUSTED: "quota_exhausted",
|
|
8
|
+
INTERNAL_ERROR: "internal_error",
|
|
9
|
+
SERVICE_UNAVAILABLE: "service_unavailable",
|
|
10
|
+
TIMEOUT: "timeout",
|
|
11
|
+
INVALID_API_KEY: "invalid_api_key",
|
|
12
|
+
CLIENT_ERROR: "client_error",
|
|
13
|
+
UNKNOWN: "unknown",
|
|
14
|
+
};
|
|
15
|
+
/** Subset of ErrorClass values that count as 'provider-side' for
|
|
16
|
+
* the provider_incident detector. */
|
|
17
|
+
export const PROVIDER_SIDE_ERROR_CLASS_VALUES = new Set([
|
|
18
|
+
"rate_limited", // RATE_LIMITED
|
|
19
|
+
"quota_exhausted", // QUOTA_EXHAUSTED
|
|
20
|
+
"internal_error", // INTERNAL_ERROR
|
|
21
|
+
"service_unavailable", // SERVICE_UNAVAILABLE
|
|
22
|
+
"timeout", // TIMEOUT
|
|
23
|
+
]);
|
|
24
|
+
//# sourceMappingURL=_errorClassesGenerated.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_errorClassesGenerated.js","sourceRoot":"","sources":["../src/_errorClassesGenerated.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,mBAAmB,EAAE,qBAAqB;IAC1C,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,OAAO,EAAE,SAAS;CACV,CAAC;AAEX;qCACqC;AACrC,MAAM,CAAC,MAAM,gCAAgC,GAAwB,IAAI,GAAG,CAAC;IAC3E,cAAc,EAAE,eAAe;IAC/B,iBAAiB,EAAE,kBAAkB;IACrC,gBAAgB,EAAE,iBAAiB;IACnC,qBAAqB,EAAE,sBAAsB;IAC7C,SAAS,EAAE,UAAU;CACtB,CAAC,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"anthropic_integration.d.ts","sourceRoot":"","sources":["../src/anthropic_integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;
|
|
1
|
+
{"version":3,"file":"anthropic_integration.d.ts","sourceRoot":"","sources":["../src/anthropic_integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA6BH;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAEhC,SAAS,EAAE;QAAE,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CACzD;AAkBD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,CAAC,EAAE,iBAAiB,GAChC,OAAO,CAAC,OAAO,CAAC,CAmKlB"}
|
|
@@ -24,11 +24,19 @@
|
|
|
24
24
|
*/
|
|
25
25
|
import { getClient } from "./client.js";
|
|
26
26
|
import { currentExecutionContext, newEventId } from "./context.js";
|
|
27
|
+
import { classifyAnthropicException, extractHttpStatus, extractRetryAfter, } from "./errors.js";
|
|
27
28
|
import { EventType, utcNowRfc3339 } from "./events.js";
|
|
29
|
+
import { _maybeEmitThrottlingEvent } from "./observe.js";
|
|
28
30
|
const MAX_SYSTEM = 1000;
|
|
29
31
|
const MAX_USER_MSG = 1000;
|
|
30
32
|
const MAX_RESPONSE = 1000;
|
|
31
33
|
const MAX_EXC_MSG = 500;
|
|
34
|
+
/** Stable lowercase provider identifier shipped on every llm_call
|
|
35
|
+
* event from this integration. Backend detectors cluster cross-
|
|
36
|
+
* tenant signals on (provider, error_class), so this string must
|
|
37
|
+
* NOT change between SDK versions without a coordinated backend
|
|
38
|
+
* change. */
|
|
39
|
+
const PROVIDER = "anthropic";
|
|
32
40
|
/** Already-patched classes, keyed by class identity to make
|
|
33
41
|
* instrumentAnthropic() idempotent and to allow distinct fake classes
|
|
34
42
|
* to be patched in tests without falsely tripping the check. */
|
|
@@ -113,6 +121,8 @@ export async function instrumentAnthropic(messagesClass) {
|
|
|
113
121
|
timestamp: utcNowRfc3339(),
|
|
114
122
|
duration_ms: durationMs,
|
|
115
123
|
payload: {
|
|
124
|
+
provider: PROVIDER,
|
|
125
|
+
surface: "chat",
|
|
116
126
|
model,
|
|
117
127
|
system_prompt: truncate(systemText, MAX_SYSTEM),
|
|
118
128
|
user_message: truncate(userMessage, MAX_USER_MSG),
|
|
@@ -127,6 +137,36 @@ export async function instrumentAnthropic(messagesClass) {
|
|
|
127
137
|
}
|
|
128
138
|
catch (err) {
|
|
129
139
|
const durationMs = Math.round(performance.now() - start);
|
|
140
|
+
// Build the failure payload with the canonical cross-
|
|
141
|
+
// provider vocabulary from ./errors. provider lets the
|
|
142
|
+
// backend group multi-provider signals; error_class maps
|
|
143
|
+
// the native exception to one of eight canonical buckets;
|
|
144
|
+
// http_status is included when the exception exposes it.
|
|
145
|
+
const failurePayload = {
|
|
146
|
+
provider: PROVIDER,
|
|
147
|
+
surface: "chat",
|
|
148
|
+
model,
|
|
149
|
+
system_prompt: truncate(systemText, MAX_SYSTEM),
|
|
150
|
+
user_message: truncate(userMessage, MAX_USER_MSG),
|
|
151
|
+
status: "failed",
|
|
152
|
+
error_class: classifyAnthropicException(err),
|
|
153
|
+
exception_type: err instanceof Error && err.constructor.name
|
|
154
|
+
? err.constructor.name
|
|
155
|
+
: typeof err,
|
|
156
|
+
exception_message: truncate(err instanceof Error ? err.message : String(err), MAX_EXC_MSG),
|
|
157
|
+
};
|
|
158
|
+
const httpStatus = extractHttpStatus(err);
|
|
159
|
+
if (httpStatus !== undefined) {
|
|
160
|
+
failurePayload.http_status = httpStatus;
|
|
161
|
+
}
|
|
162
|
+
// Provider-recommended back-off window. When present, the
|
|
163
|
+
// backend surfaces it on the provider_incident failure group
|
|
164
|
+
// so the customer's dashboard shows "back off N seconds"
|
|
165
|
+
// alongside the incident itself.
|
|
166
|
+
const retryAfter = extractRetryAfter(err);
|
|
167
|
+
if (retryAfter !== undefined) {
|
|
168
|
+
failurePayload.retry_after_seconds = retryAfter;
|
|
169
|
+
}
|
|
130
170
|
const event = {
|
|
131
171
|
event_id: eventId,
|
|
132
172
|
execution_id: ctx.executionId,
|
|
@@ -134,18 +174,19 @@ export async function instrumentAnthropic(messagesClass) {
|
|
|
134
174
|
sequence,
|
|
135
175
|
timestamp: utcNowRfc3339(),
|
|
136
176
|
duration_ms: durationMs,
|
|
137
|
-
payload:
|
|
138
|
-
model,
|
|
139
|
-
system_prompt: truncate(systemText, MAX_SYSTEM),
|
|
140
|
-
user_message: truncate(userMessage, MAX_USER_MSG),
|
|
141
|
-
status: "failed",
|
|
142
|
-
exception_type: err instanceof Error && err.constructor.name
|
|
143
|
-
? err.constructor.name
|
|
144
|
-
: typeof err,
|
|
145
|
-
exception_message: truncate(err instanceof Error ? err.message : String(err), MAX_EXC_MSG),
|
|
146
|
-
},
|
|
177
|
+
payload: failurePayload,
|
|
147
178
|
};
|
|
148
179
|
client.submitEvent(event);
|
|
180
|
+
// Wave 1.4: auto-emit infrastructure_event on throttling-class
|
|
181
|
+
// exceptions so the infrastructure_throttled detector isn't
|
|
182
|
+
// silently inactive for the default customer.
|
|
183
|
+
_maybeEmitThrottlingEvent({
|
|
184
|
+
provider: PROVIDER,
|
|
185
|
+
errorClass: failurePayload.error_class,
|
|
186
|
+
httpStatus,
|
|
187
|
+
retryAfterSeconds: retryAfter,
|
|
188
|
+
endpoint: "/v1/messages",
|
|
189
|
+
});
|
|
149
190
|
throw err;
|
|
150
191
|
}
|
|
151
192
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"anthropic_integration.js","sourceRoot":"","sources":["../src/anthropic_integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAS,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"anthropic_integration.js","sourceRoot":"","sources":["../src/anthropic_integration.ts"],"names":[],"mappings":"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"}
|
package/dist/client.d.ts
CHANGED
|
@@ -1,11 +1,21 @@
|
|
|
1
1
|
/**
|
|
2
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
|
|
@@ -14,7 +24,8 @@
|
|
|
14
24
|
* Fail-open: every observation HTTP call wraps its promise in a
|
|
15
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
|
*/
|
|
19
30
|
import { Event, Execution } from "./events.js";
|
|
20
31
|
export declare const DEFAULT_BASE_URL = "https://api.mesedi.ai";
|
|
@@ -40,6 +51,14 @@ export interface ConfigureOptions {
|
|
|
40
51
|
batchSize?: number;
|
|
41
52
|
/** Max queue depth before drop-on-full kicks in. Default 10_000. */
|
|
42
53
|
maxQueue?: number;
|
|
54
|
+
/**
|
|
55
|
+
* Per-event payload cap in bytes (#243). Events whose serialized
|
|
56
|
+
* payload exceeds this size have their longest string fields
|
|
57
|
+
* smart-truncated to fit, with marker fields stamped so downstream
|
|
58
|
+
* readers know what happened. Default 32 KB; pass 0 (or negative)
|
|
59
|
+
* to disable truncation entirely.
|
|
60
|
+
*/
|
|
61
|
+
maxPayloadBytes?: number;
|
|
43
62
|
}
|
|
44
63
|
export declare class MesediClient {
|
|
45
64
|
readonly apiKey: string;
|
|
@@ -48,6 +67,7 @@ export declare class MesediClient {
|
|
|
48
67
|
private readonly flushIntervalMs;
|
|
49
68
|
private readonly batchSize;
|
|
50
69
|
private readonly maxQueue;
|
|
70
|
+
private readonly maxPayloadBytes;
|
|
51
71
|
private queue;
|
|
52
72
|
private pendingEvents;
|
|
53
73
|
private lastFlush;
|
package/dist/client.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,EACL,KAAK,EACL,SAAS,EAIV,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AACxD,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IAEzC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAoC;gBAExC,IAAI,EAAE,gBAAgB;IAmClC,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIhD,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAI9C,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAY/B;;;;OAIG;IACH,KAAK,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAa1C;;;OAGG;IACG,QAAQ,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhD,OAAO,CAAC,OAAO;IAoBf;;;;OAIG;YACW,IAAI;YASJ,WAAW;YAiCX,kBAAkB;YAQlB,mBAAmB;YASnB,mBAAmB;IASjC;;;;OAIG;YACW,aAAa;IAmD3B;;;OAGG;YACW,QAAQ;CASvB;AAMD,wBAAgB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,YAAY,CAOnE;AAED,wBAAgB,SAAS,IAAI,YAAY,CASxC;AAED,wBAAsB,KAAK,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D"}
|
package/dist/client.js
CHANGED
|
@@ -1,11 +1,21 @@
|
|
|
1
1
|
/**
|
|
2
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
|
|
@@ -14,8 +24,11 @@
|
|
|
14
24
|
* Fail-open: every observation HTTP call wraps its promise in a
|
|
15
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
33
|
export const DEFAULT_BASE_URL = "https://api.mesedi.ai";
|
|
21
34
|
export const DEFAULT_TIMEOUT_MS = 10_000;
|
|
@@ -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();
|
|
@@ -51,6 +65,7 @@ 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
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.
|
|
@@ -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
|
/**
|
|
@@ -185,6 +208,10 @@ export class MesediClient {
|
|
|
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,8 +224,9 @@ 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);
|
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"}
|