@withgateway/sdk 0.1.3 → 0.1.5

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 (49) hide show
  1. package/dist/context/index.mjs +3 -0
  2. package/dist/context/index.mjs.map +1 -1
  3. package/dist/experiments/index.mjs +2 -0
  4. package/dist/experiments/index.mjs.map +1 -1
  5. package/dist/index-DnowA8MG.d.mts +447 -0
  6. package/dist/index-DnowA8MG.d.ts +447 -0
  7. package/dist/index.d.mts +6 -1
  8. package/dist/index.d.ts +6 -1
  9. package/dist/index.js +1715 -20
  10. package/dist/index.js.map +1 -1
  11. package/dist/index.mjs +1686 -19
  12. package/dist/index.mjs.map +1 -1
  13. package/dist/memory/index.mjs +3 -0
  14. package/dist/memory/index.mjs.map +1 -1
  15. package/dist/personas/index.d.mts +102 -0
  16. package/dist/personas/index.d.ts +102 -0
  17. package/dist/personas/index.js +205 -0
  18. package/dist/personas/index.js.map +1 -0
  19. package/dist/personas/index.mjs +180 -0
  20. package/dist/personas/index.mjs.map +1 -0
  21. package/dist/replay/index.d.mts +351 -0
  22. package/dist/replay/index.d.ts +351 -0
  23. package/dist/replay/index.js +1094 -0
  24. package/dist/replay/index.js.map +1 -0
  25. package/dist/replay/index.mjs +1057 -0
  26. package/dist/replay/index.mjs.map +1 -0
  27. package/dist/security/index.mjs +2 -0
  28. package/dist/security/index.mjs.map +1 -1
  29. package/dist/sessions/index.d.mts +143 -0
  30. package/dist/sessions/index.d.ts +143 -0
  31. package/dist/sessions/index.js +320 -0
  32. package/dist/sessions/index.js.map +1 -0
  33. package/dist/sessions/index.mjs +288 -0
  34. package/dist/sessions/index.mjs.map +1 -0
  35. package/dist/tracing/index.d.mts +3 -1
  36. package/dist/tracing/index.d.ts +3 -1
  37. package/dist/tracing/index.js +435 -8
  38. package/dist/tracing/index.js.map +1 -1
  39. package/dist/tracing/index.mjs +431 -8
  40. package/dist/tracing/index.mjs.map +1 -1
  41. package/dist/users/index.d.mts +81 -0
  42. package/dist/users/index.d.ts +81 -0
  43. package/dist/users/index.js +168 -0
  44. package/dist/users/index.js.map +1 -0
  45. package/dist/users/index.mjs +144 -0
  46. package/dist/users/index.mjs.map +1 -0
  47. package/package.json +25 -1
  48. package/dist/index-Caw3XVub.d.mts +0 -193
  49. package/dist/index-Caw3XVub.d.ts +0 -193
@@ -0,0 +1,320 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/sessions/index.ts
21
+ var sessions_exports = {};
22
+ __export(sessions_exports, {
23
+ DEFAULT_TIMEOUT_SECONDS: () => DEFAULT_TIMEOUT_SECONDS,
24
+ ENV_GATEWAY_HOST: () => ENV_GATEWAY_HOST,
25
+ ENV_GATEWAY_PUBLIC_KEY: () => ENV_GATEWAY_PUBLIC_KEY,
26
+ ENV_GATEWAY_SECRET_KEY: () => ENV_GATEWAY_SECRET_KEY,
27
+ SessionLoadError: () => SessionLoadError,
28
+ SessionRecording: () => SessionRecording,
29
+ SessionTrace: () => SessionTrace,
30
+ basicAuthHeader: () => basicAuthHeader,
31
+ loadSession: () => loadSession,
32
+ sessionObservationFromApi: () => sessionObservationFromApi,
33
+ sessions: () => sessions
34
+ });
35
+ module.exports = __toCommonJS(sessions_exports);
36
+ var import_node_fs = require("fs");
37
+ var import_node_path = require("path");
38
+ var ENV_GATEWAY_HOST = "GATEWAY_HOST";
39
+ var ENV_GATEWAY_PUBLIC_KEY = "GATEWAY_PUBLIC_KEY";
40
+ var ENV_GATEWAY_SECRET_KEY = "GATEWAY_SECRET_KEY";
41
+ var DEFAULT_TIMEOUT_SECONDS = 30;
42
+ var SessionLoadError = class extends Error {
43
+ constructor(message, options) {
44
+ super(message);
45
+ this.name = "SessionLoadError";
46
+ this.cause = options?.cause;
47
+ }
48
+ };
49
+ function sessionObservationFromApi(raw) {
50
+ return {
51
+ id: String(raw.id ?? ""),
52
+ type: asStringOrNull(raw.type),
53
+ name: asStringOrNull(raw.name),
54
+ level: asStringOrNull(raw.level),
55
+ statusMessage: asStringOrNull(raw.statusMessage),
56
+ model: asStringOrNull(raw.model),
57
+ input: raw.input,
58
+ output: raw.output,
59
+ metadata: raw.metadata ?? null,
60
+ parentObservationId: asStringOrNull(raw.parentObservationId),
61
+ startTime: raw.startTime ? String(raw.startTime) : null,
62
+ endTime: raw.endTime ? String(raw.endTime) : null
63
+ };
64
+ }
65
+ var SessionTrace = class _SessionTrace {
66
+ id;
67
+ name;
68
+ timestamp;
69
+ input;
70
+ output;
71
+ metadata;
72
+ tags;
73
+ observations;
74
+ constructor(fields) {
75
+ this.id = fields.id;
76
+ this.name = fields.name;
77
+ this.timestamp = fields.timestamp;
78
+ this.input = fields.input;
79
+ this.output = fields.output;
80
+ this.metadata = fields.metadata ?? null;
81
+ this.tags = fields.tags ?? [];
82
+ this.observations = fields.observations ?? [];
83
+ }
84
+ get toolCalls() {
85
+ return this.observations.filter(
86
+ (o) => (o.type ?? "").toUpperCase() === "TOOL"
87
+ );
88
+ }
89
+ get generations() {
90
+ return this.observations.filter(
91
+ (o) => (o.type ?? "").toUpperCase() === "GENERATION"
92
+ );
93
+ }
94
+ /**
95
+ * The user message that started this turn.
96
+ *
97
+ * Handles the common recorded shapes: a plain string input, an OpenAI
98
+ * message list (last role=user entry wins — earlier ones are carried
99
+ * history), or an object with a content/input field.
100
+ */
101
+ userMessage() {
102
+ const value = this.input;
103
+ if (typeof value === "string") {
104
+ return value;
105
+ }
106
+ if (Array.isArray(value)) {
107
+ for (let i = value.length - 1; i >= 0; i--) {
108
+ const entry = value[i];
109
+ if (isPlainObject(entry) && entry.role === "user") {
110
+ const content = entry.content;
111
+ if (typeof content === "string") {
112
+ return content;
113
+ }
114
+ if (Array.isArray(content)) {
115
+ const parts = content.filter(isPlainObject).map((part) => typeof part.text === "string" ? part.text : "");
116
+ return parts.join("") || null;
117
+ }
118
+ }
119
+ }
120
+ return null;
121
+ }
122
+ if (isPlainObject(value)) {
123
+ for (const key of ["content", "input", "text", "message"]) {
124
+ if (typeof value[key] === "string") {
125
+ return value[key];
126
+ }
127
+ }
128
+ }
129
+ return null;
130
+ }
131
+ static fromApi(raw) {
132
+ return new _SessionTrace({
133
+ id: String(raw.id ?? ""),
134
+ name: asStringOrNull(raw.name),
135
+ timestamp: raw.timestamp ? String(raw.timestamp) : null,
136
+ input: raw.input,
137
+ output: raw.output,
138
+ metadata: raw.metadata ?? null,
139
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],
140
+ observations: (Array.isArray(raw.observations) ? raw.observations : []).filter(isPlainObject).map(sessionObservationFromApi)
141
+ });
142
+ }
143
+ };
144
+ var SessionRecording = class _SessionRecording {
145
+ sessionId;
146
+ projectId;
147
+ environment;
148
+ traces;
149
+ constructor(fields) {
150
+ this.sessionId = fields.sessionId;
151
+ this.projectId = fields.projectId;
152
+ this.environment = fields.environment;
153
+ this.traces = fields.traces ?? [];
154
+ }
155
+ /** Traces in chronological order — one per agent turn. */
156
+ turns() {
157
+ return [...this.traces].sort((a, b) => {
158
+ const left = a.timestamp ?? "";
159
+ const right = b.timestamp ?? "";
160
+ return left < right ? -1 : left > right ? 1 : 0;
161
+ });
162
+ }
163
+ /** The nth chronological turn (negative indices allowed). */
164
+ turn(index) {
165
+ const ordered = this.turns();
166
+ const found = ordered.at(index);
167
+ if (!found) {
168
+ throw new RangeError(
169
+ `Turn index ${index} out of range (session has ${ordered.length} turns)`
170
+ );
171
+ }
172
+ return found;
173
+ }
174
+ /**
175
+ * The user message of each turn, in order — feed these back to an agent
176
+ * to re-drive the recorded conversation.
177
+ */
178
+ userMessages() {
179
+ return this.turns().map((trace) => trace.userMessage());
180
+ }
181
+ /** Output of the last chronological turn (null when empty). */
182
+ finalOutput() {
183
+ const ordered = this.turns();
184
+ return ordered.length > 0 ? ordered[ordered.length - 1].output : null;
185
+ }
186
+ /** Every TOOL observation across the session, chronological. */
187
+ toolCalls() {
188
+ return this.select({ type: "TOOL" });
189
+ }
190
+ /** Every GENERATION observation across the session, chronological. */
191
+ generations() {
192
+ return this.select({ type: "GENERATION" });
193
+ }
194
+ /** Filter observations across all turns (chronological order). */
195
+ select(filter = {}) {
196
+ const selected = [];
197
+ for (const trace of this.turns()) {
198
+ for (const observation of trace.observations) {
199
+ if (filter.type && (observation.type ?? "").toUpperCase() !== filter.type.toUpperCase()) {
200
+ continue;
201
+ }
202
+ if (filter.name && observation.name !== filter.name) {
203
+ continue;
204
+ }
205
+ if (filter.level && (observation.level ?? "").toUpperCase() !== filter.level.toUpperCase()) {
206
+ continue;
207
+ }
208
+ selected.push(observation);
209
+ }
210
+ }
211
+ return selected;
212
+ }
213
+ toJSON() {
214
+ return {
215
+ sessionId: this.sessionId,
216
+ projectId: this.projectId,
217
+ environment: this.environment,
218
+ traces: this.turns().map((trace) => ({
219
+ id: trace.id,
220
+ name: trace.name,
221
+ timestamp: trace.timestamp,
222
+ input: trace.input,
223
+ output: trace.output,
224
+ metadata: trace.metadata,
225
+ tags: trace.tags,
226
+ observations: trace.observations.map((o) => ({ ...o }))
227
+ }))
228
+ };
229
+ }
230
+ /** Dump the full session as a JSON fixture (for regression tests). */
231
+ toFixture(path) {
232
+ (0, import_node_fs.mkdirSync)((0, import_node_path.dirname)(path), { recursive: true });
233
+ (0, import_node_fs.writeFileSync)(path, JSON.stringify(this.toJSON(), null, 2), "utf-8");
234
+ return path;
235
+ }
236
+ static fromApi(raw) {
237
+ return new _SessionRecording({
238
+ sessionId: String(raw.id ?? ""),
239
+ projectId: asStringOrNull(raw.projectId),
240
+ environment: asStringOrNull(raw.environment),
241
+ traces: (Array.isArray(raw.traces) ? raw.traces : []).filter(isPlainObject).map(SessionTrace.fromApi)
242
+ });
243
+ }
244
+ };
245
+ async function loadSession(sessionId, options = {}) {
246
+ const host = (options.host ?? process.env[ENV_GATEWAY_HOST] ?? "").replace(
247
+ /\/+$/,
248
+ ""
249
+ );
250
+ const publicKey = options.publicKey ?? process.env[ENV_GATEWAY_PUBLIC_KEY] ?? "";
251
+ const secretKey = options.secretKey ?? process.env[ENV_GATEWAY_SECRET_KEY] ?? "";
252
+ const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
253
+ if (!host || !publicKey || !secretKey) {
254
+ throw new SessionLoadError(
255
+ "Gateway is not configured \u2014 set GATEWAY_HOST, GATEWAY_PUBLIC_KEY and GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey)."
256
+ );
257
+ }
258
+ const url = `${host}/api/public/sessions/${encodeURIComponent(sessionId)}?includeIO=true`;
259
+ let response;
260
+ try {
261
+ response = await fetch(url, {
262
+ method: "GET",
263
+ headers: { Authorization: basicAuthHeader(publicKey, secretKey) },
264
+ signal: AbortSignal.timeout(timeoutSeconds * 1e3)
265
+ });
266
+ } catch (error) {
267
+ throw new SessionLoadError(
268
+ `Failed to load session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,
269
+ { cause: error }
270
+ );
271
+ }
272
+ if (response.status === 404) {
273
+ throw new SessionLoadError(`Session not found: ${sessionId}`);
274
+ }
275
+ const text = await response.text();
276
+ if (!response.ok) {
277
+ throw new SessionLoadError(
278
+ `Failed to load session ${sessionId}: HTTP ${response.status} \u2014 ${text.slice(0, 300)}`
279
+ );
280
+ }
281
+ let payload;
282
+ try {
283
+ payload = JSON.parse(text);
284
+ } catch (error) {
285
+ throw new SessionLoadError(
286
+ `Failed to load session ${sessionId}: response is not valid JSON`,
287
+ { cause: error }
288
+ );
289
+ }
290
+ return SessionRecording.fromApi(
291
+ isPlainObject(payload) ? payload : {}
292
+ );
293
+ }
294
+ function basicAuthHeader(publicKey, secretKey) {
295
+ return `Basic ${Buffer.from(`${publicKey}:${secretKey}`).toString("base64")}`;
296
+ }
297
+ function asStringOrNull(value) {
298
+ return typeof value === "string" ? value : null;
299
+ }
300
+ function isPlainObject(value) {
301
+ return typeof value === "object" && value !== null && !Array.isArray(value);
302
+ }
303
+ var sessions = {
304
+ load: loadSession
305
+ };
306
+ // Annotate the CommonJS export names for ESM import in node:
307
+ 0 && (module.exports = {
308
+ DEFAULT_TIMEOUT_SECONDS,
309
+ ENV_GATEWAY_HOST,
310
+ ENV_GATEWAY_PUBLIC_KEY,
311
+ ENV_GATEWAY_SECRET_KEY,
312
+ SessionLoadError,
313
+ SessionRecording,
314
+ SessionTrace,
315
+ basicAuthHeader,
316
+ loadSession,
317
+ sessionObservationFromApi,
318
+ sessions
319
+ });
320
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/sessions/index.ts"],"sourcesContent":["/**\n * Load Gateway sessions for replay and test-fixture generation.\n *\n * The premier workflow: pull a real production session from the platform and\n * turn it into a regression test in your repo.\n *\n * ```typescript\n * import { loadSession } from \"@withgateway/sdk/sessions\";\n *\n * const session = await loadSession(\"session-id\"); // env-configured Gateway\n * for (const turn of session.turns()) { // (input, output) per trace\n * const result = await myAgent(turn.input);\n * assert.deepEqual(result, turn.output); // or fuzzier assertions\n * }\n *\n * session.toFixture(\"tests/fixtures/checkout_regression.json\");\n * ```\n *\n * Auth/config mirror the tracing exporter: GATEWAY_HOST, GATEWAY_PUBLIC_KEY,\n * GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey explicitly). Data comes\n * from `GET /api/public/sessions/{id}?includeIO=true` — one call, full\n * untruncated input/output for every trace and observation.\n *\n * Mirrors the Python SDK's `gatewaysdk.sessions` module.\n */\n\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nexport const ENV_GATEWAY_HOST = \"GATEWAY_HOST\";\nexport const ENV_GATEWAY_PUBLIC_KEY = \"GATEWAY_PUBLIC_KEY\";\nexport const ENV_GATEWAY_SECRET_KEY = \"GATEWAY_SECRET_KEY\";\n\nexport const DEFAULT_TIMEOUT_SECONDS = 30;\n\n/** Raised when a session cannot be loaded from Gateway. */\nexport class SessionLoadError extends Error {\n constructor(message: string, options?: { cause?: unknown }) {\n super(message);\n this.name = \"SessionLoadError\";\n this.cause = options?.cause;\n }\n}\n\n/** One observation (LLM generation, tool call, span) with full IO. */\nexport type SessionObservation = {\n id: string;\n type: string | null;\n name: string | null;\n level: string | null;\n statusMessage: string | null;\n model: string | null;\n input: unknown;\n output: unknown;\n metadata: unknown;\n parentObservationId: string | null;\n startTime: string | null;\n endTime: string | null;\n};\n\nexport function sessionObservationFromApi(\n raw: Record<string, unknown>,\n): SessionObservation {\n return {\n id: String(raw.id ?? \"\"),\n type: asStringOrNull(raw.type),\n name: asStringOrNull(raw.name),\n level: asStringOrNull(raw.level),\n statusMessage: asStringOrNull(raw.statusMessage),\n model: asStringOrNull(raw.model),\n input: raw.input,\n output: raw.output,\n metadata: raw.metadata ?? null,\n parentObservationId: asStringOrNull(raw.parentObservationId),\n startTime: raw.startTime ? String(raw.startTime) : null,\n endTime: raw.endTime ? String(raw.endTime) : null,\n };\n}\n\ntype SessionTraceFields = {\n id: string;\n name: string | null;\n timestamp: string | null;\n input: unknown;\n output: unknown;\n metadata?: unknown;\n tags?: string[];\n observations?: SessionObservation[];\n};\n\n/** One trace (agent turn) in the session, with full IO + observations. */\nexport class SessionTrace {\n readonly id: string;\n readonly name: string | null;\n readonly timestamp: string | null;\n readonly input: unknown;\n readonly output: unknown;\n readonly metadata: unknown;\n readonly tags: string[];\n readonly observations: SessionObservation[];\n\n constructor(fields: SessionTraceFields) {\n this.id = fields.id;\n this.name = fields.name;\n this.timestamp = fields.timestamp;\n this.input = fields.input;\n this.output = fields.output;\n this.metadata = fields.metadata ?? null;\n this.tags = fields.tags ?? [];\n this.observations = fields.observations ?? [];\n }\n\n get toolCalls(): SessionObservation[] {\n return this.observations.filter(\n (o) => (o.type ?? \"\").toUpperCase() === \"TOOL\",\n );\n }\n\n get generations(): SessionObservation[] {\n return this.observations.filter(\n (o) => (o.type ?? \"\").toUpperCase() === \"GENERATION\",\n );\n }\n\n /**\n * The user message that started this turn.\n *\n * Handles the common recorded shapes: a plain string input, an OpenAI\n * message list (last role=user entry wins — earlier ones are carried\n * history), or an object with a content/input field.\n */\n userMessage(): string | null {\n const value = this.input;\n if (typeof value === \"string\") {\n return value;\n }\n if (Array.isArray(value)) {\n for (let i = value.length - 1; i >= 0; i--) {\n const entry = value[i];\n if (isPlainObject(entry) && entry.role === \"user\") {\n const content = entry.content;\n if (typeof content === \"string\") {\n return content;\n }\n if (Array.isArray(content)) {\n // content-part lists\n const parts = content\n .filter(isPlainObject)\n .map((part) => (typeof part.text === \"string\" ? part.text : \"\"));\n return parts.join(\"\") || null;\n }\n }\n }\n return null;\n }\n if (isPlainObject(value)) {\n for (const key of [\"content\", \"input\", \"text\", \"message\"]) {\n if (typeof value[key] === \"string\") {\n return value[key] as string;\n }\n }\n }\n return null;\n }\n\n static fromApi(raw: Record<string, unknown>): SessionTrace {\n return new SessionTrace({\n id: String(raw.id ?? \"\"),\n name: asStringOrNull(raw.name),\n timestamp: raw.timestamp ? String(raw.timestamp) : null,\n input: raw.input,\n output: raw.output,\n metadata: raw.metadata ?? null,\n tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],\n observations: (Array.isArray(raw.observations) ? raw.observations : [])\n .filter(isPlainObject)\n .map(sessionObservationFromApi),\n });\n }\n}\n\ntype SessionRecordingFields = {\n sessionId: string;\n projectId: string | null;\n environment: string | null;\n traces?: SessionTrace[];\n};\n\ntype SelectFilter = {\n type?: string;\n name?: string;\n level?: string;\n};\n\n/** A fully-loaded session: every trace, every observation, full IO. */\nexport class SessionRecording {\n readonly sessionId: string;\n readonly projectId: string | null;\n readonly environment: string | null;\n readonly traces: SessionTrace[];\n\n constructor(fields: SessionRecordingFields) {\n this.sessionId = fields.sessionId;\n this.projectId = fields.projectId;\n this.environment = fields.environment;\n this.traces = fields.traces ?? [];\n }\n\n /** Traces in chronological order — one per agent turn. */\n turns(): SessionTrace[] {\n return [...this.traces].sort((a, b) => {\n const left = a.timestamp ?? \"\";\n const right = b.timestamp ?? \"\";\n return left < right ? -1 : left > right ? 1 : 0;\n });\n }\n\n /** The nth chronological turn (negative indices allowed). */\n turn(index: number): SessionTrace {\n const ordered = this.turns();\n const found = ordered.at(index);\n if (!found) {\n throw new RangeError(\n `Turn index ${index} out of range (session has ${ordered.length} turns)`,\n );\n }\n return found;\n }\n\n /**\n * The user message of each turn, in order — feed these back to an agent\n * to re-drive the recorded conversation.\n */\n userMessages(): Array<string | null> {\n return this.turns().map((trace) => trace.userMessage());\n }\n\n /** Output of the last chronological turn (null when empty). */\n finalOutput(): unknown {\n const ordered = this.turns();\n return ordered.length > 0 ? ordered[ordered.length - 1].output : null;\n }\n\n /** Every TOOL observation across the session, chronological. */\n toolCalls(): SessionObservation[] {\n return this.select({ type: \"TOOL\" });\n }\n\n /** Every GENERATION observation across the session, chronological. */\n generations(): SessionObservation[] {\n return this.select({ type: \"GENERATION\" });\n }\n\n /** Filter observations across all turns (chronological order). */\n select(filter: SelectFilter = {}): SessionObservation[] {\n const selected: SessionObservation[] = [];\n for (const trace of this.turns()) {\n for (const observation of trace.observations) {\n if (\n filter.type &&\n (observation.type ?? \"\").toUpperCase() !== filter.type.toUpperCase()\n ) {\n continue;\n }\n if (filter.name && observation.name !== filter.name) {\n continue;\n }\n if (\n filter.level &&\n (observation.level ?? \"\").toUpperCase() !== filter.level.toUpperCase()\n ) {\n continue;\n }\n selected.push(observation);\n }\n }\n return selected;\n }\n\n toJSON(): Record<string, unknown> {\n return {\n sessionId: this.sessionId,\n projectId: this.projectId,\n environment: this.environment,\n traces: this.turns().map((trace) => ({\n id: trace.id,\n name: trace.name,\n timestamp: trace.timestamp,\n input: trace.input,\n output: trace.output,\n metadata: trace.metadata,\n tags: trace.tags,\n observations: trace.observations.map((o) => ({ ...o })),\n })),\n };\n }\n\n /** Dump the full session as a JSON fixture (for regression tests). */\n toFixture(path: string): string {\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, JSON.stringify(this.toJSON(), null, 2), \"utf-8\");\n return path;\n }\n\n static fromApi(raw: Record<string, unknown>): SessionRecording {\n return new SessionRecording({\n sessionId: String(raw.id ?? \"\"),\n projectId: asStringOrNull(raw.projectId),\n environment: asStringOrNull(raw.environment),\n traces: (Array.isArray(raw.traces) ? raw.traces : [])\n .filter(isPlainObject)\n .map(SessionTrace.fromApi),\n });\n }\n}\n\nexport type LoadSessionOptions = {\n host?: string;\n publicKey?: string;\n secretKey?: string;\n timeoutSeconds?: number;\n};\n\n/**\n * Load a full session (all traces + observations, untruncated IO).\n *\n * Credentials default to the same environment variables the tracing\n * exporter uses: GATEWAY_HOST, GATEWAY_PUBLIC_KEY, GATEWAY_SECRET_KEY.\n */\nexport async function loadSession(\n sessionId: string,\n options: LoadSessionOptions = {},\n): Promise<SessionRecording> {\n const host = (options.host ?? process.env[ENV_GATEWAY_HOST] ?? \"\").replace(\n /\\/+$/,\n \"\",\n );\n const publicKey =\n options.publicKey ?? process.env[ENV_GATEWAY_PUBLIC_KEY] ?? \"\";\n const secretKey =\n options.secretKey ?? process.env[ENV_GATEWAY_SECRET_KEY] ?? \"\";\n const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;\n if (!host || !publicKey || !secretKey) {\n throw new SessionLoadError(\n \"Gateway is not configured — set GATEWAY_HOST, GATEWAY_PUBLIC_KEY \" +\n \"and GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey).\",\n );\n }\n\n const url = `${host}/api/public/sessions/${encodeURIComponent(sessionId)}?includeIO=true`;\n let response: Response;\n try {\n response = await fetch(url, {\n method: \"GET\",\n headers: { Authorization: basicAuthHeader(publicKey, secretKey) },\n signal: AbortSignal.timeout(timeoutSeconds * 1000),\n });\n } catch (error) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,\n { cause: error },\n );\n }\n if (response.status === 404) {\n throw new SessionLoadError(`Session not found: ${sessionId}`);\n }\n const text = await response.text();\n if (!response.ok) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: HTTP ${response.status} — ${text.slice(0, 300)}`,\n );\n }\n let payload: unknown;\n try {\n payload = JSON.parse(text);\n } catch (error) {\n throw new SessionLoadError(\n `Failed to load session ${sessionId}: response is not valid JSON`,\n { cause: error },\n );\n }\n return SessionRecording.fromApi(\n isPlainObject(payload) ? payload : {},\n );\n}\n\nexport function basicAuthHeader(publicKey: string, secretKey: string): string {\n return `Basic ${Buffer.from(`${publicKey}:${secretKey}`).toString(\"base64\")}`;\n}\n\nfunction asStringOrNull(value: unknown): string | null {\n return typeof value === \"string\" ? value : null;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport const sessions = {\n load: loadSession,\n};\n"],"mappings":"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","names":[]}
@@ -0,0 +1,288 @@
1
+ import { createRequire as __gatewayCreateRequire } from "module";
2
+ const require = __gatewayCreateRequire(import.meta.url);
3
+
4
+ // src/sessions/index.ts
5
+ import { mkdirSync, writeFileSync } from "fs";
6
+ import { dirname } from "path";
7
+ var ENV_GATEWAY_HOST = "GATEWAY_HOST";
8
+ var ENV_GATEWAY_PUBLIC_KEY = "GATEWAY_PUBLIC_KEY";
9
+ var ENV_GATEWAY_SECRET_KEY = "GATEWAY_SECRET_KEY";
10
+ var DEFAULT_TIMEOUT_SECONDS = 30;
11
+ var SessionLoadError = class extends Error {
12
+ constructor(message, options) {
13
+ super(message);
14
+ this.name = "SessionLoadError";
15
+ this.cause = options?.cause;
16
+ }
17
+ };
18
+ function sessionObservationFromApi(raw) {
19
+ return {
20
+ id: String(raw.id ?? ""),
21
+ type: asStringOrNull(raw.type),
22
+ name: asStringOrNull(raw.name),
23
+ level: asStringOrNull(raw.level),
24
+ statusMessage: asStringOrNull(raw.statusMessage),
25
+ model: asStringOrNull(raw.model),
26
+ input: raw.input,
27
+ output: raw.output,
28
+ metadata: raw.metadata ?? null,
29
+ parentObservationId: asStringOrNull(raw.parentObservationId),
30
+ startTime: raw.startTime ? String(raw.startTime) : null,
31
+ endTime: raw.endTime ? String(raw.endTime) : null
32
+ };
33
+ }
34
+ var SessionTrace = class _SessionTrace {
35
+ id;
36
+ name;
37
+ timestamp;
38
+ input;
39
+ output;
40
+ metadata;
41
+ tags;
42
+ observations;
43
+ constructor(fields) {
44
+ this.id = fields.id;
45
+ this.name = fields.name;
46
+ this.timestamp = fields.timestamp;
47
+ this.input = fields.input;
48
+ this.output = fields.output;
49
+ this.metadata = fields.metadata ?? null;
50
+ this.tags = fields.tags ?? [];
51
+ this.observations = fields.observations ?? [];
52
+ }
53
+ get toolCalls() {
54
+ return this.observations.filter(
55
+ (o) => (o.type ?? "").toUpperCase() === "TOOL"
56
+ );
57
+ }
58
+ get generations() {
59
+ return this.observations.filter(
60
+ (o) => (o.type ?? "").toUpperCase() === "GENERATION"
61
+ );
62
+ }
63
+ /**
64
+ * The user message that started this turn.
65
+ *
66
+ * Handles the common recorded shapes: a plain string input, an OpenAI
67
+ * message list (last role=user entry wins — earlier ones are carried
68
+ * history), or an object with a content/input field.
69
+ */
70
+ userMessage() {
71
+ const value = this.input;
72
+ if (typeof value === "string") {
73
+ return value;
74
+ }
75
+ if (Array.isArray(value)) {
76
+ for (let i = value.length - 1; i >= 0; i--) {
77
+ const entry = value[i];
78
+ if (isPlainObject(entry) && entry.role === "user") {
79
+ const content = entry.content;
80
+ if (typeof content === "string") {
81
+ return content;
82
+ }
83
+ if (Array.isArray(content)) {
84
+ const parts = content.filter(isPlainObject).map((part) => typeof part.text === "string" ? part.text : "");
85
+ return parts.join("") || null;
86
+ }
87
+ }
88
+ }
89
+ return null;
90
+ }
91
+ if (isPlainObject(value)) {
92
+ for (const key of ["content", "input", "text", "message"]) {
93
+ if (typeof value[key] === "string") {
94
+ return value[key];
95
+ }
96
+ }
97
+ }
98
+ return null;
99
+ }
100
+ static fromApi(raw) {
101
+ return new _SessionTrace({
102
+ id: String(raw.id ?? ""),
103
+ name: asStringOrNull(raw.name),
104
+ timestamp: raw.timestamp ? String(raw.timestamp) : null,
105
+ input: raw.input,
106
+ output: raw.output,
107
+ metadata: raw.metadata ?? null,
108
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : [],
109
+ observations: (Array.isArray(raw.observations) ? raw.observations : []).filter(isPlainObject).map(sessionObservationFromApi)
110
+ });
111
+ }
112
+ };
113
+ var SessionRecording = class _SessionRecording {
114
+ sessionId;
115
+ projectId;
116
+ environment;
117
+ traces;
118
+ constructor(fields) {
119
+ this.sessionId = fields.sessionId;
120
+ this.projectId = fields.projectId;
121
+ this.environment = fields.environment;
122
+ this.traces = fields.traces ?? [];
123
+ }
124
+ /** Traces in chronological order — one per agent turn. */
125
+ turns() {
126
+ return [...this.traces].sort((a, b) => {
127
+ const left = a.timestamp ?? "";
128
+ const right = b.timestamp ?? "";
129
+ return left < right ? -1 : left > right ? 1 : 0;
130
+ });
131
+ }
132
+ /** The nth chronological turn (negative indices allowed). */
133
+ turn(index) {
134
+ const ordered = this.turns();
135
+ const found = ordered.at(index);
136
+ if (!found) {
137
+ throw new RangeError(
138
+ `Turn index ${index} out of range (session has ${ordered.length} turns)`
139
+ );
140
+ }
141
+ return found;
142
+ }
143
+ /**
144
+ * The user message of each turn, in order — feed these back to an agent
145
+ * to re-drive the recorded conversation.
146
+ */
147
+ userMessages() {
148
+ return this.turns().map((trace) => trace.userMessage());
149
+ }
150
+ /** Output of the last chronological turn (null when empty). */
151
+ finalOutput() {
152
+ const ordered = this.turns();
153
+ return ordered.length > 0 ? ordered[ordered.length - 1].output : null;
154
+ }
155
+ /** Every TOOL observation across the session, chronological. */
156
+ toolCalls() {
157
+ return this.select({ type: "TOOL" });
158
+ }
159
+ /** Every GENERATION observation across the session, chronological. */
160
+ generations() {
161
+ return this.select({ type: "GENERATION" });
162
+ }
163
+ /** Filter observations across all turns (chronological order). */
164
+ select(filter = {}) {
165
+ const selected = [];
166
+ for (const trace of this.turns()) {
167
+ for (const observation of trace.observations) {
168
+ if (filter.type && (observation.type ?? "").toUpperCase() !== filter.type.toUpperCase()) {
169
+ continue;
170
+ }
171
+ if (filter.name && observation.name !== filter.name) {
172
+ continue;
173
+ }
174
+ if (filter.level && (observation.level ?? "").toUpperCase() !== filter.level.toUpperCase()) {
175
+ continue;
176
+ }
177
+ selected.push(observation);
178
+ }
179
+ }
180
+ return selected;
181
+ }
182
+ toJSON() {
183
+ return {
184
+ sessionId: this.sessionId,
185
+ projectId: this.projectId,
186
+ environment: this.environment,
187
+ traces: this.turns().map((trace) => ({
188
+ id: trace.id,
189
+ name: trace.name,
190
+ timestamp: trace.timestamp,
191
+ input: trace.input,
192
+ output: trace.output,
193
+ metadata: trace.metadata,
194
+ tags: trace.tags,
195
+ observations: trace.observations.map((o) => ({ ...o }))
196
+ }))
197
+ };
198
+ }
199
+ /** Dump the full session as a JSON fixture (for regression tests). */
200
+ toFixture(path) {
201
+ mkdirSync(dirname(path), { recursive: true });
202
+ writeFileSync(path, JSON.stringify(this.toJSON(), null, 2), "utf-8");
203
+ return path;
204
+ }
205
+ static fromApi(raw) {
206
+ return new _SessionRecording({
207
+ sessionId: String(raw.id ?? ""),
208
+ projectId: asStringOrNull(raw.projectId),
209
+ environment: asStringOrNull(raw.environment),
210
+ traces: (Array.isArray(raw.traces) ? raw.traces : []).filter(isPlainObject).map(SessionTrace.fromApi)
211
+ });
212
+ }
213
+ };
214
+ async function loadSession(sessionId, options = {}) {
215
+ const host = (options.host ?? process.env[ENV_GATEWAY_HOST] ?? "").replace(
216
+ /\/+$/,
217
+ ""
218
+ );
219
+ const publicKey = options.publicKey ?? process.env[ENV_GATEWAY_PUBLIC_KEY] ?? "";
220
+ const secretKey = options.secretKey ?? process.env[ENV_GATEWAY_SECRET_KEY] ?? "";
221
+ const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
222
+ if (!host || !publicKey || !secretKey) {
223
+ throw new SessionLoadError(
224
+ "Gateway is not configured \u2014 set GATEWAY_HOST, GATEWAY_PUBLIC_KEY and GATEWAY_SECRET_KEY (or pass host/publicKey/secretKey)."
225
+ );
226
+ }
227
+ const url = `${host}/api/public/sessions/${encodeURIComponent(sessionId)}?includeIO=true`;
228
+ let response;
229
+ try {
230
+ response = await fetch(url, {
231
+ method: "GET",
232
+ headers: { Authorization: basicAuthHeader(publicKey, secretKey) },
233
+ signal: AbortSignal.timeout(timeoutSeconds * 1e3)
234
+ });
235
+ } catch (error) {
236
+ throw new SessionLoadError(
237
+ `Failed to load session ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,
238
+ { cause: error }
239
+ );
240
+ }
241
+ if (response.status === 404) {
242
+ throw new SessionLoadError(`Session not found: ${sessionId}`);
243
+ }
244
+ const text = await response.text();
245
+ if (!response.ok) {
246
+ throw new SessionLoadError(
247
+ `Failed to load session ${sessionId}: HTTP ${response.status} \u2014 ${text.slice(0, 300)}`
248
+ );
249
+ }
250
+ let payload;
251
+ try {
252
+ payload = JSON.parse(text);
253
+ } catch (error) {
254
+ throw new SessionLoadError(
255
+ `Failed to load session ${sessionId}: response is not valid JSON`,
256
+ { cause: error }
257
+ );
258
+ }
259
+ return SessionRecording.fromApi(
260
+ isPlainObject(payload) ? payload : {}
261
+ );
262
+ }
263
+ function basicAuthHeader(publicKey, secretKey) {
264
+ return `Basic ${Buffer.from(`${publicKey}:${secretKey}`).toString("base64")}`;
265
+ }
266
+ function asStringOrNull(value) {
267
+ return typeof value === "string" ? value : null;
268
+ }
269
+ function isPlainObject(value) {
270
+ return typeof value === "object" && value !== null && !Array.isArray(value);
271
+ }
272
+ var sessions = {
273
+ load: loadSession
274
+ };
275
+ export {
276
+ DEFAULT_TIMEOUT_SECONDS,
277
+ ENV_GATEWAY_HOST,
278
+ ENV_GATEWAY_PUBLIC_KEY,
279
+ ENV_GATEWAY_SECRET_KEY,
280
+ SessionLoadError,
281
+ SessionRecording,
282
+ SessionTrace,
283
+ basicAuthHeader,
284
+ loadSession,
285
+ sessionObservationFromApi,
286
+ sessions
287
+ };
288
+ //# sourceMappingURL=index.mjs.map