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 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
package/dist/events.d.ts CHANGED
@@ -1,16 +1,16 @@
1
1
  /**
2
- * Event types and execution records — the TypeScript mirror of the Go
2
+ * Event types and execution records, the TypeScript mirror of the Go
3
3
  * backend's wire format and the Python SDK's data model.
4
4
  *
5
5
  * Source-of-truth lives in the Go backend at
6
6
  * `backend/internal/events/types.go`. Any new EventType or Status
7
- * added there MUST be added here too — strict-JSON decoding on the
7
+ * added there MUST be added here too, strict-JSON decoding on the
8
8
  * backend will reject events whose fields it doesn't recognize.
9
9
  *
10
10
  * The wire format uses RFC 3339 UTC timestamps for every time field.
11
11
  */
12
12
  /**
13
- * RFC 3339 UTC timestamp with microsecond precision — the format the
13
+ * RFC 3339 UTC timestamp with microsecond precision, the format the
14
14
  * Go backend's time.Time RFC3339 marshaller accepts. Example:
15
15
  * "2026-05-14T22:17:33.123456Z".
16
16
  *
@@ -32,6 +32,12 @@ export declare const EventType: {
32
32
  readonly VALIDATOR_RESULT: "validator_result";
33
33
  readonly DRIFT_SIGNAL: "drift_signal";
34
34
  readonly INJECTION_ALERT: "injection_alert";
35
+ readonly INFRASTRUCTURE_EVENT: "infrastructure_event";
36
+ readonly MCP_CALL: "mcp_call";
37
+ readonly EVAL_SCORE: "eval_score";
38
+ readonly MEMORY_OPERATION: "memory_operation";
39
+ readonly AGENT_HANDOFF: "agent_handoff";
40
+ readonly HUMAN_INTERVENTION: "human_intervention";
35
41
  };
36
42
  export type EventType = (typeof EventType)[keyof typeof EventType];
37
43
  /**
@@ -63,9 +69,16 @@ export interface Execution {
63
69
  sdk_language: "typescript";
64
70
  sdk_version: string;
65
71
  crash_signature?: string;
72
+ /**
73
+ * Mesedi #5: optional per-execution tenant identifier from the
74
+ * host SaaS application. When set, surfaces in the cost-by-tenant
75
+ * report; absent means "not supplied" and the run rolls up under
76
+ * the "(unattributed)" bucket on the dashboard.
77
+ */
78
+ tenant_id?: string;
66
79
  }
67
80
  /**
68
- * A single observation within an execution. Payload is opaque JSON —
81
+ * A single observation within an execution. Payload is opaque JSON ,
69
82
  * the backend stores it as a raw blob; per-event-type payload shapes
70
83
  * are defined in the typed payload helpers below.
71
84
  */
@@ -79,12 +92,12 @@ export interface Event {
79
92
  payload: Record<string, unknown>;
80
93
  }
81
94
  /**
82
- * Build the body for POST /executions — only the fields valid at
95
+ * Build the body for POST /executions, only the fields valid at
83
96
  * execution start.
84
97
  */
85
98
  export declare function executionStartPayload(e: Execution): Record<string, unknown>;
86
99
  /**
87
- * Build the body for PATCH /executions/{id} — omit any undefined
100
+ * Build the body for PATCH /executions/{id}, omit any undefined
88
101
  * fields so the backend's strict-decode doesn't reject them.
89
102
  */
90
103
  export declare function executionEndPayload(e: Execution): Record<string, unknown>;
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW7D"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;CA8BZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW7D"}
package/dist/events.js CHANGED
@@ -1,16 +1,16 @@
1
1
  /**
2
- * Event types and execution records — the TypeScript mirror of the Go
2
+ * Event types and execution records, the TypeScript mirror of the Go
3
3
  * backend's wire format and the Python SDK's data model.
4
4
  *
5
5
  * Source-of-truth lives in the Go backend at
6
6
  * `backend/internal/events/types.go`. Any new EventType or Status
7
- * added there MUST be added here too — strict-JSON decoding on the
7
+ * added there MUST be added here too, strict-JSON decoding on the
8
8
  * backend will reject events whose fields it doesn't recognize.
9
9
  *
10
10
  * The wire format uses RFC 3339 UTC timestamps for every time field.
11
11
  */
12
12
  /**
13
- * RFC 3339 UTC timestamp with microsecond precision — the format the
13
+ * RFC 3339 UTC timestamp with microsecond precision, the format the
14
14
  * Go backend's time.Time RFC3339 marshaller accepts. Example:
15
15
  * "2026-05-14T22:17:33.123456Z".
16
16
  *
@@ -38,6 +38,28 @@ export const EventType = {
38
38
  VALIDATOR_RESULT: "validator_result",
39
39
  DRIFT_SIGNAL: "drift_signal",
40
40
  INJECTION_ALERT: "injection_alert",
41
+ // Mesedi #2: transport-plane backpressure (HTTP 429, circuit breaker
42
+ // trip, hard quota exhaustion). Consumed by the
43
+ // infrastructure_throttled detector on the backend.
44
+ INFRASTRUCTURE_EVENT: "infrastructure_event",
45
+ // Mesedi #7: Model Context Protocol server invocation. Peer to
46
+ // TOOL_CALL but with explicit server identity so cost / failure
47
+ // attribution can break down per MCP server.
48
+ MCP_CALL: "mcp_call",
49
+ // Mesedi #9: external evaluator score (Ragas / Promptfoo / HHEM
50
+ // / custom). Ingestion-only; Mesedi #14 aggregates these into
51
+ // grounding_failure clusters.
52
+ EVAL_SCORE: "eval_score",
53
+ // Mesedi #15: external memory store read/write/search.
54
+ MEMORY_OPERATION: "memory_operation",
55
+ // Mesedi #11: cross-agent task delegation. The downstream
56
+ // cascading_failure detector (#12) correlates the handoff with
57
+ // the resolved child execution via the topology graph (#10).
58
+ AGENT_HANDOFF: "agent_handoff",
59
+ // Mesedi #19: one full HITL ask/answer cycle. Emitted at the
60
+ // moment the human's decision lands. Aggregated by the
61
+ // hitl_timeout (#20) and hitl_rejection_spike (#21) detectors.
62
+ HUMAN_INTERVENTION: "human_intervention",
41
63
  };
42
64
  /**
43
65
  * Execution lifecycle states. Must match `ExecutionStatus` constants
@@ -52,20 +74,23 @@ export const Status = {
52
74
  VALIDATION_FAILED: "validation_failed",
53
75
  };
54
76
  /**
55
- * Build the body for POST /executions — only the fields valid at
77
+ * Build the body for POST /executions, only the fields valid at
56
78
  * execution start.
57
79
  */
58
80
  export function executionStartPayload(e) {
59
- return {
81
+ const out = {
60
82
  execution_id: e.execution_id,
61
83
  status: e.status,
62
84
  started_at: e.started_at,
63
85
  sdk_language: e.sdk_language,
64
86
  sdk_version: e.sdk_version,
65
87
  };
88
+ if (e.tenant_id !== undefined)
89
+ out["tenant_id"] = e.tenant_id;
90
+ return out;
66
91
  }
67
92
  /**
68
- * Build the body for PATCH /executions/{id} — omit any undefined
93
+ * Build the body for PATCH /executions/{id}, omit any undefined
69
94
  * fields so the backend's strict-decode doesn't reject them.
70
95
  */
71
96
  export function executionEndPayload(e) {
@@ -1 +1 @@
1
- {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,oEAAoE;IACpE,iEAAiE;IACjE,yDAAyD;IACzD,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAoCX;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAY;IAChD,OAAO;QACL,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAAY;IAC9C,MAAM,GAAG,GAA4B,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1D,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3D,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACpE,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAChF,IAAI,CAAC,CAAC,gBAAgB,KAAK,SAAS;QAAE,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,gBAAgB,CAAC;IACnF,IAAI,CAAC,CAAC,kBAAkB,KAAK,SAAS;QAAE,GAAG,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC;IACzF,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS;QAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,MAAM,GAAG,GAA4B;QACnC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC;IACF,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC"}
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Google Gemini TypeScript SDK monkey-patch — auto-emit llm_call
3
+ * events for every GenerativeModel.generateContent() call inside a
4
+ * wrap()'d execution.
5
+ *
6
+ * Targets the @google/generative-ai package (the dominant non-
7
+ * Vertex Gemini TS surface). Mirrors instrumentAnthropic /
8
+ * instrumentOpenAI / instrumentCohere in fail-open semantics,
9
+ * canonical error vocabulary, idempotency.
10
+ *
11
+ * Out of scope (filed as #271 follow-ups):
12
+ * - generateContentStream / chat sessions
13
+ * - Vertex AI surface (@google-cloud/vertexai)
14
+ *
15
+ * Dependency injection: instrumentGemini accepts an optional class
16
+ * argument so this is testable without installing the package.
17
+ */
18
+ export interface GenerativeModelClassLike {
19
+ prototype: {
20
+ generateContent: (...args: any[]) => Promise<any>;
21
+ };
22
+ }
23
+ /** Patch GenerativeModel.generateContent to emit llm_call events. */
24
+ export declare function instrumentGemini(modelClass?: GenerativeModelClassLike): Promise<boolean>;
25
+ export interface GenerativeModelEmbedClassLike {
26
+ prototype: {
27
+ embedContent: (...args: any[]) => Promise<any>;
28
+ };
29
+ }
30
+ /** Patch GenerativeModel.embedContent to emit
31
+ * surface='embeddings' llm_call events. Idempotent per class. */
32
+ export declare function patchGeminiEmbedContent(cls: GenerativeModelEmbedClassLike): void;
33
+ //# sourceMappingURL=gemini_integration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini_integration.d.ts","sourceRoot":"","sources":["../src/gemini_integration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqBH,MAAM,WAAW,wBAAwB;IAEvC,SAAS,EAAE;QAAE,eAAe,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CAClE;AAqBD,qEAAqE;AACrE,wBAAsB,gBAAgB,CACpC,UAAU,CAAC,EAAE,wBAAwB,GACpC,OAAO,CAAC,OAAO,CAAC,CA8HlB;AAmFD,MAAM,WAAW,6BAA6B;IAE5C,SAAS,EAAE;QAAE,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CAC/D;AAkBD;iEACiE;AACjE,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,6BAA6B,GACjC,IAAI,CA+FN"}
@@ -0,0 +1,334 @@
1
+ /**
2
+ * Google Gemini TypeScript SDK monkey-patch — auto-emit llm_call
3
+ * events for every GenerativeModel.generateContent() call inside a
4
+ * wrap()'d execution.
5
+ *
6
+ * Targets the @google/generative-ai package (the dominant non-
7
+ * Vertex Gemini TS surface). Mirrors instrumentAnthropic /
8
+ * instrumentOpenAI / instrumentCohere in fail-open semantics,
9
+ * canonical error vocabulary, idempotency.
10
+ *
11
+ * Out of scope (filed as #271 follow-ups):
12
+ * - generateContentStream / chat sessions
13
+ * - Vertex AI surface (@google-cloud/vertexai)
14
+ *
15
+ * Dependency injection: instrumentGemini accepts an optional class
16
+ * argument so this is testable without installing the package.
17
+ */
18
+ import { getClient } from "./client.js";
19
+ import { currentExecutionContext, newEventId } from "./context.js";
20
+ import { classifyGeminiException, extractHttpStatus, extractRetryAfter, } from "./errors.js";
21
+ import { EventType, utcNowRfc3339 } from "./events.js";
22
+ import { _maybeEmitThrottlingEvent } from "./observe.js";
23
+ const MAX_SYSTEM = 1000;
24
+ const MAX_USER_MSG = 1000;
25
+ const MAX_RESPONSE = 1000;
26
+ const MAX_EXC_MSG = 500;
27
+ const PROVIDER = "gemini";
28
+ const _patched = new WeakSet();
29
+ /** Patch GenerativeModel.generateContent to emit llm_call events. */
30
+ export async function instrumentGemini(modelClass) {
31
+ let cls = modelClass;
32
+ if (!cls) {
33
+ try {
34
+ // eslint-disable-next-line @typescript-eslint/ban-ts-comment
35
+ // @ts-ignore — package may not be installed; by design.
36
+ const mod = (await import("@google/generative-ai"));
37
+ cls = mod?.GenerativeModel;
38
+ }
39
+ catch {
40
+ console.warn("mesedi: @google/generative-ai not installed; instrumentGemini() is a no-op. " +
41
+ "Install with `npm install @google/generative-ai` to enable.");
42
+ return false;
43
+ }
44
+ if (!cls)
45
+ return false;
46
+ }
47
+ if (_patched.has(cls))
48
+ return true;
49
+ const originalGenerate = cls.prototype.generateContent;
50
+ cls.prototype.generateContent = async function patchedGenerate(...args) {
51
+ const ctx = currentExecutionContext();
52
+ if (!ctx)
53
+ return originalGenerate.apply(this, args);
54
+ ctx.checkBudget();
55
+ if (ctx.budgetTracker)
56
+ ctx.budgetTracker.incrementSteps();
57
+ const client = getClient();
58
+ const sequence = ctx.nextSequence();
59
+ const eventId = newEventId();
60
+ const selfRecord = this;
61
+ const model = typeof selfRecord.model === "string"
62
+ ? selfRecord.model
63
+ : typeof selfRecord.modelName === "string"
64
+ ? selfRecord.modelName
65
+ : "unknown";
66
+ // System instruction is set when the GenerativeModel is
67
+ // constructed (`systemInstruction` option). It surfaces on the
68
+ // instance as `systemInstruction` (string OR Content object).
69
+ const systemRaw = selfRecord.systemInstruction;
70
+ const systemText = stringifyContent(systemRaw);
71
+ const userMessage = extractUserMessage(args[0]);
72
+ const start = performance.now();
73
+ try {
74
+ const response = (await originalGenerate.apply(this, args));
75
+ const durationMs = Math.round(performance.now() - start);
76
+ const { responseText, inputTokens, outputTokens } = extractResponseFields(response);
77
+ if (ctx.budgetTracker)
78
+ ctx.budgetTracker.addTokens(inputTokens, outputTokens);
79
+ client.submitEvent({
80
+ event_id: eventId,
81
+ execution_id: ctx.executionId,
82
+ event_type: EventType.LLM_CALL,
83
+ sequence,
84
+ timestamp: utcNowRfc3339(),
85
+ duration_ms: durationMs,
86
+ payload: {
87
+ provider: PROVIDER,
88
+ surface: "chat",
89
+ model,
90
+ system_prompt: truncate(systemText, MAX_SYSTEM),
91
+ user_message: truncate(userMessage, MAX_USER_MSG),
92
+ response_text: truncate(responseText, MAX_RESPONSE),
93
+ status: "ok",
94
+ input_tokens: inputTokens,
95
+ output_tokens: outputTokens,
96
+ },
97
+ });
98
+ return response;
99
+ }
100
+ catch (err) {
101
+ const durationMs = Math.round(performance.now() - start);
102
+ const failurePayload = {
103
+ provider: PROVIDER,
104
+ surface: "chat",
105
+ model,
106
+ system_prompt: truncate(systemText, MAX_SYSTEM),
107
+ user_message: truncate(userMessage, MAX_USER_MSG),
108
+ status: "failed",
109
+ error_class: classifyGeminiException(err),
110
+ exception_type: err instanceof Error && err.constructor.name
111
+ ? err.constructor.name
112
+ : typeof err,
113
+ exception_message: truncate(err instanceof Error ? err.message : String(err), MAX_EXC_MSG),
114
+ };
115
+ const httpStatus = extractHttpStatus(err);
116
+ if (httpStatus !== undefined)
117
+ failurePayload.http_status = httpStatus;
118
+ const retryAfter = extractRetryAfter(err);
119
+ if (retryAfter !== undefined)
120
+ failurePayload.retry_after_seconds = retryAfter;
121
+ client.submitEvent({
122
+ event_id: eventId,
123
+ execution_id: ctx.executionId,
124
+ event_type: EventType.LLM_CALL,
125
+ sequence,
126
+ timestamp: utcNowRfc3339(),
127
+ duration_ms: durationMs,
128
+ payload: failurePayload,
129
+ });
130
+ // Wave 1.4: auto-emit infrastructure_event on throttling-class
131
+ // exceptions so infrastructure_throttled isn't silently inactive.
132
+ _maybeEmitThrottlingEvent({
133
+ provider: PROVIDER,
134
+ errorClass: failurePayload.error_class,
135
+ httpStatus,
136
+ retryAfterSeconds: retryAfter,
137
+ endpoint: "/v1/models/generateContent",
138
+ });
139
+ throw err;
140
+ }
141
+ };
142
+ _patched.add(cls);
143
+ return true;
144
+ }
145
+ function extractUserMessage(arg) {
146
+ if (typeof arg === "string")
147
+ return arg;
148
+ if (Array.isArray(arg)) {
149
+ // Array of strings OR Content objects. Walk for the last
150
+ // role:user (or any role-less string) entry.
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 (typeof obj.text === "string")
160
+ return obj.text;
161
+ if (Array.isArray(obj.parts)) {
162
+ const parts = [];
163
+ for (const p of obj.parts) {
164
+ if (typeof p?.text === "string")
165
+ parts.push(p.text);
166
+ }
167
+ return parts.join("\n");
168
+ }
169
+ }
170
+ }
171
+ return "";
172
+ }
173
+ if (arg && typeof arg === "object") {
174
+ // GenerateContentRequest-like: { contents: [...] }
175
+ const obj = arg;
176
+ if (obj.contents !== undefined)
177
+ return extractUserMessage(obj.contents);
178
+ }
179
+ return "";
180
+ }
181
+ function stringifyContent(content) {
182
+ if (typeof content === "string")
183
+ return content;
184
+ if (!content || typeof content !== "object")
185
+ return "";
186
+ const obj = content;
187
+ if (typeof obj.text === "string")
188
+ return obj.text;
189
+ if (Array.isArray(obj.parts)) {
190
+ const bits = [];
191
+ for (const p of obj.parts) {
192
+ if (typeof p?.text === "string")
193
+ bits.push(p.text);
194
+ }
195
+ return bits.join("\n");
196
+ }
197
+ return "";
198
+ }
199
+ function extractResponseFields(response) {
200
+ let responseText = "";
201
+ let inputTokens = 0;
202
+ let outputTokens = 0;
203
+ try {
204
+ if (typeof response?.response?.text === "function") {
205
+ const text = response.response.text();
206
+ if (typeof text === "string")
207
+ responseText = text;
208
+ }
209
+ }
210
+ catch {
211
+ /* best-effort */
212
+ }
213
+ try {
214
+ const usage = response?.response?.usageMetadata;
215
+ if (usage) {
216
+ inputTokens = Number(usage.promptTokenCount ?? 0) || 0;
217
+ outputTokens = Number(usage.candidatesTokenCount ?? 0) || 0;
218
+ }
219
+ }
220
+ catch {
221
+ /* best-effort */
222
+ }
223
+ return { responseText, inputTokens, outputTokens };
224
+ }
225
+ function truncate(s, max) {
226
+ if (s.length <= max)
227
+ return s;
228
+ return s.slice(0, max - 3) + "...";
229
+ }
230
+ const _embedPatched = new WeakSet();
231
+ function extractEmbedContentInput(arg) {
232
+ if (typeof arg === "string")
233
+ return arg;
234
+ if (arg && typeof arg === "object") {
235
+ const obj = arg;
236
+ if (obj.content !== undefined) {
237
+ const c = obj.content;
238
+ if (typeof c === "string")
239
+ return c;
240
+ return stringifyContent(c);
241
+ }
242
+ return stringifyContent(arg);
243
+ }
244
+ return "";
245
+ }
246
+ /** Patch GenerativeModel.embedContent to emit
247
+ * surface='embeddings' llm_call events. Idempotent per class. */
248
+ export function patchGeminiEmbedContent(cls) {
249
+ if (_embedPatched.has(cls))
250
+ return;
251
+ const originalEmbed = cls.prototype.embedContent;
252
+ cls.prototype.embedContent = async function patchedEmbed(...args) {
253
+ const ctx = currentExecutionContext();
254
+ if (!ctx)
255
+ return originalEmbed.apply(this, args);
256
+ ctx.checkBudget();
257
+ if (ctx.budgetTracker)
258
+ ctx.budgetTracker.incrementSteps();
259
+ const client = getClient();
260
+ const sequence = ctx.nextSequence();
261
+ const eventId = newEventId();
262
+ const selfRecord = this;
263
+ const model = typeof selfRecord.model === "string"
264
+ ? selfRecord.model
265
+ : typeof selfRecord.modelName === "string"
266
+ ? selfRecord.modelName
267
+ : "unknown";
268
+ const userMessage = extractEmbedContentInput(args[0]);
269
+ const start = performance.now();
270
+ try {
271
+ const response = await originalEmbed.apply(this, args);
272
+ const durationMs = Math.round(performance.now() - start);
273
+ client.submitEvent({
274
+ event_id: eventId,
275
+ execution_id: ctx.executionId,
276
+ event_type: EventType.LLM_CALL,
277
+ sequence,
278
+ timestamp: utcNowRfc3339(),
279
+ duration_ms: durationMs,
280
+ payload: {
281
+ provider: PROVIDER,
282
+ surface: "embeddings",
283
+ model,
284
+ user_message: truncate(userMessage, MAX_USER_MSG),
285
+ response_text: "<embedding vectors>",
286
+ status: "ok",
287
+ input_tokens: 0,
288
+ output_tokens: 0,
289
+ },
290
+ });
291
+ return response;
292
+ }
293
+ catch (err) {
294
+ const durationMs = Math.round(performance.now() - start);
295
+ const failurePayload = {
296
+ provider: PROVIDER,
297
+ surface: "embeddings",
298
+ model,
299
+ user_message: truncate(userMessage, MAX_USER_MSG),
300
+ status: "failed",
301
+ error_class: classifyGeminiException(err),
302
+ exception_type: err instanceof Error && err.constructor.name
303
+ ? err.constructor.name
304
+ : typeof err,
305
+ exception_message: truncate(err instanceof Error ? err.message : String(err), MAX_EXC_MSG),
306
+ };
307
+ const httpStatus = extractHttpStatus(err);
308
+ if (httpStatus !== undefined)
309
+ failurePayload.http_status = httpStatus;
310
+ const retryAfter = extractRetryAfter(err);
311
+ if (retryAfter !== undefined)
312
+ failurePayload.retry_after_seconds = retryAfter;
313
+ client.submitEvent({
314
+ event_id: eventId,
315
+ execution_id: ctx.executionId,
316
+ event_type: EventType.LLM_CALL,
317
+ sequence,
318
+ timestamp: utcNowRfc3339(),
319
+ duration_ms: durationMs,
320
+ payload: failurePayload,
321
+ });
322
+ _maybeEmitThrottlingEvent({
323
+ provider: PROVIDER,
324
+ errorClass: failurePayload.error_class,
325
+ httpStatus,
326
+ retryAfterSeconds: retryAfter,
327
+ endpoint: "/v1/models/embedContent",
328
+ });
329
+ throw err;
330
+ }
331
+ };
332
+ _embedPatched.add(cls);
333
+ }
334
+ //# sourceMappingURL=gemini_integration.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gemini_integration.js","sourceRoot":"","sources":["../src/gemini_integration.ts"],"names":[],"mappings":"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"}
package/dist/halt.d.ts CHANGED
@@ -1,14 +1,14 @@
1
1
  /**
2
- * Hard-halt primitives — TypeScript port of the Python `mesedi/halt.py`.
2
+ * Hard-halt primitives, TypeScript port of the Python `mesedi/halt.py`.
3
3
  *
4
4
  * Three exports:
5
5
  *
6
- * - `Budget` — interface describing the per-execution limits
6
+ * - `Budget`: interface describing the per-execution limits
7
7
  * (wall-clock seconds, step count, input/output
8
8
  * tokens). Any subset of fields can be set; unset
9
9
  * fields are "no limit on that axis."
10
10
  *
11
- * - `MesediHalt` — Error subclass that the runtime throws when a
11
+ * - `MesediHalt`, Error subclass that the runtime throws when a
12
12
  * `Budget` is exceeded. Carries a `reason` and a
13
13
  * `trigger` so callers / dashboards can tell which
14
14
  * axis blew the budget. Marked with an internal
@@ -17,15 +17,15 @@
17
17
  * `try { ... } catch (err) { ... }` and re-threw
18
18
  * something else.
19
19
  *
20
- * - `BudgetTracker` — runtime counter struct. One per execution.
20
+ * - `BudgetTracker`, runtime counter struct. One per execution.
21
21
  * Tracks wall-clock start (via `performance.now()`
22
- * — JS's monotonic clock equivalent of Python's
22
+ *: JS's monotonic clock equivalent of Python's
23
23
  * `time.monotonic()`), step count, token totals.
24
24
  * `check()` throws MesediHalt if any limit is
25
25
  * exceeded; the wrap()'d entry points call it as
26
26
  * a halt-safe boundary BEFORE doing work, so the
27
27
  * halt always fires between tool/llm/checkpoint
28
- * calls — never mid-call.
28
+ * calls, never mid-call.
29
29
  *
30
30
  * Cross-language wire-format parity:
31
31
  *
@@ -44,7 +44,7 @@
44
44
  * Why a marker Symbol on MesediHalt:
45
45
  *
46
46
  * In Python, `MesediHalt(BaseException)` evades `except Exception:`
47
- * handlers — broad except blocks miss it. JavaScript has no
47
+ * handlers, broad except blocks miss it. JavaScript has no
48
48
  * equivalent of BaseException; `catch (err)` always catches
49
49
  * everything. So we mark MesediHalt with a hidden Symbol-keyed
50
50
  * property and `wrap()` looks for that symbol, not just an
@@ -84,7 +84,7 @@ export interface Budget {
84
84
  */
85
85
  declare const MESEDI_HALT_MARKER: unique symbol;
86
86
  /**
87
- * Trigger that caused a halt — embedded in the crash_signature
87
+ * Trigger that caused a halt, embedded in the crash_signature
88
88
  * (`halt:wall_clock`) so the dashboard groups halts by cause.
89
89
  */
90
90
  export type HaltTrigger = "wall_clock" | "step_count" | "token_total" | "remote_signal";
@@ -110,15 +110,15 @@ export declare class MesediHalt extends Error {
110
110
  export declare function isMesediHalt(err: unknown): err is MesediHalt;
111
111
  /**
112
112
  * Runtime counter struct. One instance per execution, lives on the
113
- * ExecutionContext. Thread-safety isn't a concern in Node — the
114
- * single-threaded event loop guarantees serial access — but the
113
+ * ExecutionContext. Thread-safety isn't a concern in Node, the
114
+ * single-threaded event loop guarantees serial access, but the
115
115
  * counter writes still need to be coherent across async boundaries,
116
116
  * which AsyncLocalStorage gives us for free.
117
117
  *
118
118
  * `check()` is the halt-safe boundary. Callers (tool, anthropic
119
119
  * patch, checkpoint) call it FIRST, then increment counters. If any
120
120
  * limit is already exceeded at the time of check, a MesediHalt is
121
- * thrown — the caller's work is never started.
121
+ * thrown, the caller's work is never started.
122
122
  */
123
123
  export declare class BudgetTracker {
124
124
  private readonly budget;
@@ -136,7 +136,7 @@ export declare class BudgetTracker {
136
136
  * `check()` call will throw `MesediHalt(trigger='remote_signal')`
137
137
  * with the supplied reason.
138
138
  *
139
- * Idempotent — multiple signals overwrite the reason (last one
139
+ * Idempotent, multiple signals overwrite the reason (last one
140
140
  * wins). Concurrency is fine: Node's single-threaded event loop
141
141
  * means the reader thread's write and the agent thread's read
142
142
  * can't interleave at the JS level.