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.
Files changed (104) hide show
  1. package/README.md +81 -31
  2. package/dist/_errorClassesGenerated.d.ts +18 -0
  3. package/dist/_errorClassesGenerated.d.ts.map +1 -0
  4. package/dist/_errorClassesGenerated.js +24 -0
  5. package/dist/_errorClassesGenerated.js.map +1 -0
  6. package/dist/anthropic_integration.d.ts +9 -9
  7. package/dist/anthropic_integration.d.ts.map +1 -1
  8. package/dist/anthropic_integration.js +67 -26
  9. package/dist/anthropic_integration.js.map +1 -1
  10. package/dist/client.d.ts +32 -12
  11. package/dist/client.d.ts.map +1 -1
  12. package/dist/client.js +46 -18
  13. package/dist/client.js.map +1 -1
  14. package/dist/cohere_integration.d.ts +42 -0
  15. package/dist/cohere_integration.d.ts.map +1 -0
  16. package/dist/cohere_integration.js +456 -0
  17. package/dist/cohere_integration.js.map +1 -0
  18. package/dist/compress.d.ts +69 -0
  19. package/dist/compress.d.ts.map +1 -0
  20. package/dist/compress.js +75 -0
  21. package/dist/compress.js.map +1 -0
  22. package/dist/context.d.ts +13 -4
  23. package/dist/context.d.ts.map +1 -1
  24. package/dist/context.js +15 -5
  25. package/dist/context.js.map +1 -1
  26. package/dist/errors.d.ts +137 -0
  27. package/dist/errors.d.ts.map +1 -0
  28. package/dist/errors.js +462 -0
  29. package/dist/errors.js.map +1 -0
  30. package/dist/events.d.ts +19 -6
  31. package/dist/events.d.ts.map +1 -1
  32. package/dist/events.js +31 -6
  33. package/dist/events.js.map +1 -1
  34. package/dist/gemini_integration.d.ts +33 -0
  35. package/dist/gemini_integration.d.ts.map +1 -0
  36. package/dist/gemini_integration.js +334 -0
  37. package/dist/gemini_integration.js.map +1 -0
  38. package/dist/halt.d.ts +12 -12
  39. package/dist/halt.js +16 -16
  40. package/dist/halt.js.map +1 -1
  41. package/dist/halt_stream.d.ts +6 -6
  42. package/dist/halt_stream.d.ts.map +1 -1
  43. package/dist/halt_stream.js +22 -12
  44. package/dist/halt_stream.js.map +1 -1
  45. package/dist/index.d.ts +26 -13
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +20 -12
  48. package/dist/index.js.map +1 -1
  49. package/dist/integrations/langgraph.d.ts +99 -0
  50. package/dist/integrations/langgraph.d.ts.map +1 -0
  51. package/dist/integrations/langgraph.js +572 -0
  52. package/dist/integrations/langgraph.js.map +1 -0
  53. package/dist/integrations/mastra.d.ts +114 -0
  54. package/dist/integrations/mastra.d.ts.map +1 -0
  55. package/dist/integrations/mastra.js +354 -0
  56. package/dist/integrations/mastra.js.map +1 -0
  57. package/dist/integrations/openai_agents.d.ts +66 -0
  58. package/dist/integrations/openai_agents.d.ts.map +1 -0
  59. package/dist/integrations/openai_agents.js +243 -0
  60. package/dist/integrations/openai_agents.js.map +1 -0
  61. package/dist/integrations/promptfoo.d.ts +62 -0
  62. package/dist/integrations/promptfoo.d.ts.map +1 -0
  63. package/dist/integrations/promptfoo.js +76 -0
  64. package/dist/integrations/promptfoo.js.map +1 -0
  65. package/dist/integrations/ragas.d.ts +65 -0
  66. package/dist/integrations/ragas.d.ts.map +1 -0
  67. package/dist/integrations/ragas.js +78 -0
  68. package/dist/integrations/ragas.js.map +1 -0
  69. package/dist/integrations/vectara.d.ts +60 -0
  70. package/dist/integrations/vectara.d.ts.map +1 -0
  71. package/dist/integrations/vectara.js +59 -0
  72. package/dist/integrations/vectara.js.map +1 -0
  73. package/dist/integrations/vercel_ai.d.ts +6 -6
  74. package/dist/integrations/vercel_ai.js +10 -10
  75. package/dist/integrations/vercel_ai.js.map +1 -1
  76. package/dist/observe.d.ts +358 -3
  77. package/dist/observe.d.ts.map +1 -1
  78. package/dist/observe.js +536 -4
  79. package/dist/observe.js.map +1 -1
  80. package/dist/ollama_integration.d.ts +126 -0
  81. package/dist/ollama_integration.d.ts.map +1 -0
  82. package/dist/ollama_integration.js +404 -0
  83. package/dist/ollama_integration.js.map +1 -0
  84. package/dist/openai_integration.d.ts +67 -0
  85. package/dist/openai_integration.d.ts.map +1 -0
  86. package/dist/openai_integration.js +574 -0
  87. package/dist/openai_integration.js.map +1 -0
  88. package/dist/tool.d.ts +1 -1
  89. package/dist/tool.d.ts.map +1 -1
  90. package/dist/tool.js +193 -10
  91. package/dist/tool.js.map +1 -1
  92. package/dist/truncate.d.ts +84 -0
  93. package/dist/truncate.d.ts.map +1 -0
  94. package/dist/truncate.js +134 -0
  95. package/dist/truncate.js.map +1 -0
  96. package/dist/vertex_gemini_integration.d.ts +27 -0
  97. package/dist/vertex_gemini_integration.d.ts.map +1 -0
  98. package/dist/vertex_gemini_integration.js +229 -0
  99. package/dist/vertex_gemini_integration.js.map +1 -0
  100. package/dist/wrap.d.ts +39 -3
  101. package/dist/wrap.d.ts.map +1 -1
  102. package/dist/wrap.js +15 -12
  103. package/dist/wrap.js.map +1 -1
  104. package/package.json +28 -4
@@ -0,0 +1,229 @@
1
+ /**
2
+ * Vertex AI Gemini TypeScript SDK monkey-patch — auto-emit llm_call
3
+ * events for every GenerativeModel.generateContent() call inside a
4
+ * wrap()'d execution against the Vertex AI surface
5
+ * (@google-cloud/vertexai package).
6
+ *
7
+ * Same provider tag ("gemini") and same canonical error_class map
8
+ * as instrumentGemini. Customers running both surfaces call both
9
+ * instrumentGemini() and instrumentVertexGemini() — each patches a
10
+ * different package's class. Provider_incident detection sees one
11
+ * signal regardless of which surface was hit.
12
+ *
13
+ * Dependency injection: instrumentVertexGemini accepts an optional
14
+ * class argument so this code is testable without installing
15
+ * @google-cloud/vertexai.
16
+ */
17
+ import { getClient } from "./client.js";
18
+ import { currentExecutionContext, newEventId } from "./context.js";
19
+ import { classifyGeminiException, extractHttpStatus, extractRetryAfter, } from "./errors.js";
20
+ import { EventType, utcNowRfc3339 } from "./events.js";
21
+ import { _maybeEmitThrottlingEvent } from "./observe.js";
22
+ const MAX_SYSTEM = 1000;
23
+ const MAX_USER_MSG = 1000;
24
+ const MAX_RESPONSE = 1000;
25
+ const MAX_EXC_MSG = 500;
26
+ const PROVIDER = "gemini";
27
+ const ENDPOINT = "/v1/projects/*/locations/*/publishers/google/models/*:generateContent";
28
+ const _patched = new WeakSet();
29
+ /** Patch Vertex AI's GenerativeModel.generateContent to emit
30
+ * llm_call events. Returns true if patched OR was a no-op re-patch.
31
+ * Returns false if @google-cloud/vertexai isn't installed AND no
32
+ * class was provided. */
33
+ export async function instrumentVertexGemini(modelClass) {
34
+ let cls = modelClass;
35
+ if (!cls) {
36
+ try {
37
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
38
+ // @ts-ignore — package may not be installed; by design.
39
+ const mod = (await import("@google-cloud/vertexai"));
40
+ cls = mod?.GenerativeModel;
41
+ }
42
+ catch {
43
+ console.warn("mesedi: @google-cloud/vertexai not installed; " +
44
+ "instrumentVertexGemini() is a no-op. " +
45
+ "Install with `npm install @google-cloud/vertexai` to enable.");
46
+ return false;
47
+ }
48
+ if (!cls)
49
+ return false;
50
+ }
51
+ if (_patched.has(cls))
52
+ return true;
53
+ const originalGenerate = cls.prototype.generateContent;
54
+ cls.prototype.generateContent = async function patchedGenerate(...args) {
55
+ const ctx = currentExecutionContext();
56
+ if (!ctx)
57
+ return originalGenerate.apply(this, args);
58
+ ctx.checkBudget();
59
+ if (ctx.budgetTracker)
60
+ ctx.budgetTracker.incrementSteps();
61
+ const client = getClient();
62
+ const sequence = ctx.nextSequence();
63
+ const eventId = newEventId();
64
+ const selfRecord = this;
65
+ // Vertex stores the model identifier on different attrs across
66
+ // SDK versions; walk the candidates defensively.
67
+ const model = (typeof selfRecord.model === "string" && selfRecord.model) ||
68
+ (typeof selfRecord.modelName === "string" && selfRecord.modelName) ||
69
+ (typeof selfRecord._publisherModel === "string" &&
70
+ selfRecord._publisherModel) ||
71
+ "unknown";
72
+ const systemRaw = selfRecord.systemInstruction ?? selfRecord._systemInstruction;
73
+ const systemText = stringifySystemInstruction(systemRaw);
74
+ const userMessage = extractUserMessage(args[0]);
75
+ const start = performance.now();
76
+ try {
77
+ const response = (await originalGenerate.apply(this, args));
78
+ const durationMs = Math.round(performance.now() - start);
79
+ const { responseText, inputTokens, outputTokens } = extractResponseFields(response);
80
+ if (ctx.budgetTracker)
81
+ ctx.budgetTracker.addTokens(inputTokens, outputTokens);
82
+ client.submitEvent({
83
+ event_id: eventId,
84
+ execution_id: ctx.executionId,
85
+ event_type: EventType.LLM_CALL,
86
+ sequence,
87
+ timestamp: utcNowRfc3339(),
88
+ duration_ms: durationMs,
89
+ payload: {
90
+ provider: PROVIDER,
91
+ surface: "chat",
92
+ model,
93
+ system_prompt: truncate(systemText, MAX_SYSTEM),
94
+ user_message: truncate(userMessage, MAX_USER_MSG),
95
+ response_text: truncate(responseText, MAX_RESPONSE),
96
+ status: "ok",
97
+ input_tokens: inputTokens,
98
+ output_tokens: outputTokens,
99
+ },
100
+ });
101
+ return response;
102
+ }
103
+ catch (err) {
104
+ const durationMs = Math.round(performance.now() - start);
105
+ const failurePayload = {
106
+ provider: PROVIDER,
107
+ surface: "chat",
108
+ model,
109
+ system_prompt: truncate(systemText, MAX_SYSTEM),
110
+ user_message: truncate(userMessage, MAX_USER_MSG),
111
+ status: "failed",
112
+ error_class: classifyGeminiException(err),
113
+ exception_type: err instanceof Error && err.constructor.name
114
+ ? err.constructor.name
115
+ : typeof err,
116
+ exception_message: truncate(err instanceof Error ? err.message : String(err), MAX_EXC_MSG),
117
+ };
118
+ const httpStatus = extractHttpStatus(err);
119
+ if (httpStatus !== undefined)
120
+ failurePayload.http_status = httpStatus;
121
+ const retryAfter = extractRetryAfter(err);
122
+ if (retryAfter !== undefined)
123
+ failurePayload.retry_after_seconds = retryAfter;
124
+ client.submitEvent({
125
+ event_id: eventId,
126
+ execution_id: ctx.executionId,
127
+ event_type: EventType.LLM_CALL,
128
+ sequence,
129
+ timestamp: utcNowRfc3339(),
130
+ duration_ms: durationMs,
131
+ payload: failurePayload,
132
+ });
133
+ _maybeEmitThrottlingEvent({
134
+ provider: PROVIDER,
135
+ errorClass: failurePayload.error_class,
136
+ httpStatus,
137
+ retryAfterSeconds: retryAfter,
138
+ endpoint: ENDPOINT,
139
+ });
140
+ throw err;
141
+ }
142
+ };
143
+ _patched.add(cls);
144
+ return true;
145
+ }
146
+ function extractUserMessage(arg) {
147
+ if (typeof arg === "string")
148
+ return arg;
149
+ if (Array.isArray(arg)) {
150
+ // Walk backward looking for the last role:user (or role-less).
151
+ for (let i = arg.length - 1; i >= 0; i--) {
152
+ const item = arg[i];
153
+ if (typeof item === "string")
154
+ return item;
155
+ if (item && typeof item === "object") {
156
+ const obj = item;
157
+ if (obj.role && obj.role !== "user")
158
+ continue;
159
+ if (Array.isArray(obj.parts)) {
160
+ const parts = [];
161
+ for (const p of obj.parts) {
162
+ if (typeof p?.text === "string")
163
+ parts.push(p.text);
164
+ }
165
+ return parts.join("\n");
166
+ }
167
+ }
168
+ }
169
+ return "";
170
+ }
171
+ if (arg && typeof arg === "object") {
172
+ // GenerateContentRequest-like: { contents: [...] }
173
+ const obj = arg;
174
+ if (obj.contents !== undefined)
175
+ return extractUserMessage(obj.contents);
176
+ }
177
+ return "";
178
+ }
179
+ function stringifySystemInstruction(content) {
180
+ if (typeof content === "string")
181
+ return content;
182
+ if (!content || typeof content !== "object")
183
+ return "";
184
+ const obj = content;
185
+ if (Array.isArray(obj.parts)) {
186
+ const bits = [];
187
+ for (const p of obj.parts) {
188
+ if (typeof p?.text === "string")
189
+ bits.push(p.text);
190
+ }
191
+ return bits.join("\n");
192
+ }
193
+ return "";
194
+ }
195
+ function extractResponseFields(response) {
196
+ let responseText = "";
197
+ let inputTokens = 0;
198
+ let outputTokens = 0;
199
+ try {
200
+ const candidates = response?.response?.candidates ?? [];
201
+ const parts = candidates[0]?.content?.parts ?? [];
202
+ const bits = [];
203
+ for (const p of parts) {
204
+ if (typeof p?.text === "string")
205
+ bits.push(p.text);
206
+ }
207
+ responseText = bits.join("\n");
208
+ }
209
+ catch {
210
+ /* best-effort */
211
+ }
212
+ try {
213
+ const usage = response?.response?.usageMetadata;
214
+ if (usage) {
215
+ inputTokens = Number(usage.promptTokenCount ?? 0) || 0;
216
+ outputTokens = Number(usage.candidatesTokenCount ?? 0) || 0;
217
+ }
218
+ }
219
+ catch {
220
+ /* best-effort */
221
+ }
222
+ return { responseText, inputTokens, outputTokens };
223
+ }
224
+ function truncate(s, max) {
225
+ if (s.length <= max)
226
+ return s;
227
+ return s.slice(0, max - 3) + "...";
228
+ }
229
+ //# sourceMappingURL=vertex_gemini_integration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vertex_gemini_integration.js","sourceRoot":"","sources":["../src/vertex_gemini_integration.ts"],"names":[],"mappings":"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"}
package/dist/wrap.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * wrap() — Mesedi's primary observation primitive for TypeScript.
2
+ * wrap(), Mesedi's primary observation primitive for TypeScript.
3
3
  *
4
4
  * TypeScript doesn't have stable decorators in regular JS, so wrap()
5
5
  * is a HIGHER-ORDER FUNCTION rather than a decorator. The shape:
@@ -51,15 +51,51 @@ export interface WrapOptions {
51
51
  * Optional per-execution budget. When set, the wrapped function
52
52
  * runs with halt-safe boundary checks at every `tool()` /
53
53
  * `checkpoint()` / Anthropic LLM-call entry point. If any limit is
54
- * exceeded between calls, a MesediHalt is thrown internally —
54
+ * exceeded between calls, a MesediHalt is thrown internally ,
55
55
  * wrap() catches it, marks the execution status=halted (with
56
56
  * crash_signature=`halt:<trigger>`), and returns undefined.
57
57
  *
58
58
  * The wrapped function's normal try/finally cleanup runs as
59
- * expected — halt is raised AT a safe boundary, never mid-tool /
59
+ * expected, halt is raised AT a safe boundary, never mid-tool /
60
60
  * mid-LLM-call, so user resources release cleanly.
61
61
  */
62
62
  budget?: Budget;
63
+ /**
64
+ * Mesedi #5: optional per-execution tenant identifier from the
65
+ * host SaaS application (an end-user ID, customer ID, etc.). When
66
+ * set, every execution this wrap produces is attributed to that
67
+ * tenant and surfaces in `GET /reports/cost-by-tenant`. Omit on
68
+ * single-tenant projects.
69
+ *
70
+ * Typically captured from the request context at the call site:
71
+ *
72
+ * export const handler = wrap(
73
+ * { tenant_id: req.session.customerId },
74
+ * async (input) => { ... },
75
+ * );
76
+ */
77
+ tenant_id?: string;
78
+ /**
79
+ * Mesedi #11 (Wave 1.2.b): optional human-readable agent name. When
80
+ * set, `emitAgentHandoff` will use it as a fallback when the caller
81
+ * does not pass `fromAgent`, letting multi-agent code avoid
82
+ * repeating the same string at every handoff site:
83
+ *
84
+ * export const planner = wrap(
85
+ * { agentName: "planner" },
86
+ * async (query: string) => {
87
+ * emitAgentHandoff({ toAgent: "reviewer", ... });
88
+ * // ^ from_agent="planner" inferred from context
89
+ * },
90
+ * );
91
+ *
92
+ * Explicit `fromAgent` always wins. If neither is supplied while
93
+ * inside `wrap()`, `emitAgentHandoff` throws an Error rather than
94
+ * silently emitting an `unknown` source agent — the topology graph
95
+ * powers cascading_failure / coordination_deadlock clustering and
96
+ * must not be polluted.
97
+ */
98
+ agentName?: string;
63
99
  }
64
100
  /**
65
101
  * Wrap an async function so each call is recorded as an agent
@@ -1 +1 @@
1
- {"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAaH,OAAO,EAAE,MAAM,EAA+B,MAAM,WAAW,CAAC;AAGhE,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnD,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EAC9D,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CA0GlD"}
1
+ {"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAaH,OAAO,EAAE,MAAM,EAA+B,MAAM,WAAW,CAAC;AAGhE,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnD,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EAC9D,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CA8GlD"}
package/dist/wrap.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * wrap() — Mesedi's primary observation primitive for TypeScript.
2
+ * wrap(), Mesedi's primary observation primitive for TypeScript.
3
3
  *
4
4
  * TypeScript doesn't have stable decorators in regular JS, so wrap()
5
5
  * is a HIGHER-ORDER FUNCTION rather than a decorator. The shape:
@@ -49,22 +49,22 @@ import { HaltStreamReader } from "./halt_stream.js";
49
49
  */
50
50
  export function wrap(fnOrOpts, maybeFn) {
51
51
  // Support both call shapes:
52
- // wrap(fn) — no options
53
- // wrap({...opts}, fn) — with options
52
+ // wrap(fn), no options
53
+ // wrap({...opts}, fn), with options
54
54
  let opts;
55
55
  let fn;
56
56
  if (typeof fnOrOpts === "function") {
57
57
  opts = {};
58
58
  // Cast: `typeof === "function"` narrows to the broad built-in
59
59
  // `Function` type rather than to our specific signature, but at
60
- // runtime it IS our signature — the call site guarantees that
60
+ // runtime it IS our signature, the call site guarantees that
61
61
  // shape since the function position is statically typed.
62
62
  fn = fnOrOpts;
63
63
  }
64
64
  else {
65
65
  opts = fnOrOpts;
66
66
  if (!maybeFn) {
67
- throw new TypeError("wrap() requires a function — pass either wrap(fn) or wrap(options, fn).");
67
+ throw new TypeError("wrap() requires a function, pass either wrap(fn) or wrap(options, fn).");
68
68
  }
69
69
  fn = maybeFn;
70
70
  }
@@ -79,10 +79,13 @@ export function wrap(fnOrOpts, maybeFn) {
79
79
  status: Status.STARTED,
80
80
  started_at: utcNowRfc3339(),
81
81
  sdk_language: "typescript",
82
- sdk_version: "0.0.4",
82
+ sdk_version: "0.6.0",
83
+ // Optional tenant_id flows through to the wire body via
84
+ // executionStartPayload's omitempty-style assignment.
85
+ ...(opts.tenant_id !== undefined ? { tenant_id: opts.tenant_id } : {}),
83
86
  };
84
87
  // Construct a budget tracker iff a budget was supplied. Stays
85
- // undefined for un-budgeted wraps — checkBudget() then no-ops.
88
+ // undefined for un-budgeted wraps, checkBudget() then no-ops.
86
89
  const tracker = opts.budget ? new BudgetTracker(opts.budget) : undefined;
87
90
  // Sub-slice 21e: if a budget is configured, spawn an SSE reader
88
91
  // subscribed to /executions/{id}/halt-stream. When the backend
@@ -105,7 +108,7 @@ export function wrap(fnOrOpts, maybeFn) {
105
108
  client.submitExecutionStart(execution);
106
109
  const startWall = performance.now();
107
110
  try {
108
- const result = await runInExecutionContext(executionId, () => fn(...args), tracker);
111
+ const result = await runInExecutionContext(executionId, () => fn(...args), tracker, opts.agentName);
109
112
  execution.status = Status.COMPLETED;
110
113
  execution.duration_ms = Math.round(performance.now() - startWall);
111
114
  execution.ended_at = utcNowRfc3339();
@@ -116,16 +119,16 @@ export function wrap(fnOrOpts, maybeFn) {
116
119
  execution.duration_ms = Math.round(performance.now() - startWall);
117
120
  execution.ended_at = utcNowRfc3339();
118
121
  if (isMesediHalt(err)) {
119
- // Controlled halt — record as halted, NOT crashed. The
122
+ // Controlled halt, record as halted, NOT crashed. The
120
123
  // crash_signature carries the trigger so the dashboard can
121
- // group halts by cause (`halt:wall_clock` etc.) — same wire
124
+ // group halts by cause (`halt:wall_clock` etc.), same wire
122
125
  // format the Python SDK emits.
123
126
  execution.status = Status.HALTED;
124
127
  // err is narrowed to MesediHalt here by isMesediHalt's type
125
128
  // guard, so the trigger access is type-safe.
126
129
  execution.crash_signature = `halt:${err.trigger}`;
127
130
  client.submitExecutionEnd(execution);
128
- // Return undefined — DON'T re-throw. The halt is a
131
+ // Return undefined, DON'T re-throw. The halt is a
129
132
  // controlled stop; the caller's downstream code should NOT
130
133
  // see an exception. This matches Python's `return None`
131
134
  // behavior in wrap.py.
@@ -149,7 +152,7 @@ export function wrap(fnOrOpts, maybeFn) {
149
152
  *
150
153
  * Matches the Python SDK formula: SHA-256 of (error class name +
151
154
  * the first 5 lines of the formatted error). Truncates to 16 hex
152
- * chars — collision-resistant at scale, easy to display in
155
+ * chars, collision-resistant at scale, easy to display in
153
156
  * dashboards.
154
157
  *
155
158
  * The backend's Phase-3a crash grouper uses the same input shape, so
package/dist/wrap.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"wrap.js","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wrap.js","sourceRoot":"","sources":["../src/wrap.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mesedi",
3
- "version": "0.1.0",
3
+ "version": "0.6.0",
4
4
  "description": "Mesedi SDK — guardians for autonomous AI agents. Detect failures, halt runaways, escalate first occurrence.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://mesedi.ai",
@@ -12,7 +12,7 @@
12
12
  "bugs": {
13
13
  "url": "https://github.com/mesedi-ai/mesedi/issues"
14
14
  },
15
- "author": "Robert J. Canario <mesediai@gmail.com>",
15
+ "author": "Robert J. Canario <hello@mesedi.ai>",
16
16
  "type": "module",
17
17
  "main": "./dist/index.js",
18
18
  "types": "./dist/index.d.ts",
@@ -24,14 +24,34 @@
24
24
  "./integrations/vercel_ai": {
25
25
  "types": "./dist/integrations/vercel_ai.d.ts",
26
26
  "import": "./dist/integrations/vercel_ai.js"
27
+ },
28
+ "./integrations/langgraph": {
29
+ "types": "./dist/integrations/langgraph.d.ts",
30
+ "import": "./dist/integrations/langgraph.js"
31
+ },
32
+ "./integrations/openai_agents": {
33
+ "types": "./dist/integrations/openai_agents.d.ts",
34
+ "import": "./dist/integrations/openai_agents.js"
35
+ },
36
+ "./integrations/mastra": {
37
+ "types": "./dist/integrations/mastra.d.ts",
38
+ "import": "./dist/integrations/mastra.js"
27
39
  }
28
40
  },
29
41
  "peerDependencies": {
30
- "ai": ">=3.0.0"
42
+ "ai": ">=3.0.0",
43
+ "@mastra/core": ">=1.0.0",
44
+ "@mastra/observability": ">=1.0.0"
31
45
  },
32
46
  "peerDependenciesMeta": {
33
47
  "ai": {
34
48
  "optional": true
49
+ },
50
+ "@mastra/core": {
51
+ "optional": true
52
+ },
53
+ "@mastra/observability": {
54
+ "optional": true
35
55
  }
36
56
  },
37
57
  "files": [
@@ -42,6 +62,7 @@
42
62
  "build": "tsc",
43
63
  "build:sandbox": "tsc -p tsconfig.sandbox.json",
44
64
  "clean": "rm -rf dist dist-sandbox",
65
+ "test": "vitest run",
45
66
  "test:sandbox": "npm run build:sandbox && node dist-sandbox/sandbox/real_agent.js",
46
67
  "test:parity": "npm run build:sandbox && node dist-sandbox/sandbox/parity_test.js"
47
68
  },
@@ -65,6 +86,9 @@
65
86
  },
66
87
  "devDependencies": {
67
88
  "typescript": "^5.4.0",
68
- "@types/node": "^20.11.0"
89
+ "@types/node": "^20.11.0",
90
+ "vitest": "^4.1.9",
91
+ "@mastra/core": "^1.48.0",
92
+ "@mastra/observability": "^1.15.2"
69
93
  }
70
94
  }