@arizeai/phoenix-client 6.9.3 → 6.10.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 (53) hide show
  1. package/dist/esm/__generated__/api/v1.d.ts +72 -20
  2. package/dist/esm/__generated__/api/v1.d.ts.map +1 -1
  3. package/dist/esm/constants/serverRequirements.d.ts +3 -0
  4. package/dist/esm/constants/serverRequirements.d.ts.map +1 -1
  5. package/dist/esm/constants/serverRequirements.js +24 -0
  6. package/dist/esm/constants/serverRequirements.js.map +1 -1
  7. package/dist/esm/sessions/addSessionNote.d.ts +11 -2
  8. package/dist/esm/sessions/addSessionNote.d.ts.map +1 -1
  9. package/dist/esm/sessions/addSessionNote.js +12 -3
  10. package/dist/esm/sessions/addSessionNote.js.map +1 -1
  11. package/dist/esm/spans/addSpanNote.d.ts +11 -5
  12. package/dist/esm/spans/addSpanNote.d.ts.map +1 -1
  13. package/dist/esm/spans/addSpanNote.js +13 -5
  14. package/dist/esm/spans/addSpanNote.js.map +1 -1
  15. package/dist/esm/spans/getSpanAnnotations.d.ts +1 -1
  16. package/dist/esm/spans/getSpanAnnotations.d.ts.map +1 -1
  17. package/dist/esm/traces/addTraceNote.d.ts +11 -5
  18. package/dist/esm/traces/addTraceNote.d.ts.map +1 -1
  19. package/dist/esm/traces/addTraceNote.js +12 -6
  20. package/dist/esm/traces/addTraceNote.js.map +1 -1
  21. package/dist/esm/tsconfig.esm.tsbuildinfo +1 -1
  22. package/dist/esm/utils/formatPromptMessages.d.ts.map +1 -1
  23. package/dist/esm/utils/getPromptBySelector.d.ts.map +1 -1
  24. package/dist/src/__generated__/api/v1.d.ts +72 -20
  25. package/dist/src/__generated__/api/v1.d.ts.map +1 -1
  26. package/dist/src/constants/serverRequirements.d.ts +3 -0
  27. package/dist/src/constants/serverRequirements.d.ts.map +1 -1
  28. package/dist/src/constants/serverRequirements.js +25 -1
  29. package/dist/src/constants/serverRequirements.js.map +1 -1
  30. package/dist/src/sessions/addSessionNote.d.ts +11 -2
  31. package/dist/src/sessions/addSessionNote.d.ts.map +1 -1
  32. package/dist/src/sessions/addSessionNote.js +11 -2
  33. package/dist/src/sessions/addSessionNote.js.map +1 -1
  34. package/dist/src/spans/addSpanNote.d.ts +11 -5
  35. package/dist/src/spans/addSpanNote.d.ts.map +1 -1
  36. package/dist/src/spans/addSpanNote.js +13 -5
  37. package/dist/src/spans/addSpanNote.js.map +1 -1
  38. package/dist/src/spans/getSpanAnnotations.d.ts +1 -1
  39. package/dist/src/spans/getSpanAnnotations.d.ts.map +1 -1
  40. package/dist/src/traces/addTraceNote.d.ts +11 -5
  41. package/dist/src/traces/addTraceNote.d.ts.map +1 -1
  42. package/dist/src/traces/addTraceNote.js +11 -5
  43. package/dist/src/traces/addTraceNote.js.map +1 -1
  44. package/dist/src/utils/formatPromptMessages.d.ts.map +1 -1
  45. package/dist/src/utils/getPromptBySelector.d.ts.map +1 -1
  46. package/dist/tsconfig.tsbuildinfo +1 -1
  47. package/package.json +1 -1
  48. package/src/__generated__/api/v1.ts +72 -20
  49. package/src/constants/serverRequirements.ts +27 -0
  50. package/src/sessions/addSessionNote.ts +22 -3
  51. package/src/spans/addSpanNote.ts +20 -5
  52. package/src/spans/getSpanAnnotations.ts +1 -1
  53. package/src/traces/addTraceNote.ts +22 -6
@@ -24,6 +24,9 @@ export declare const GET_SPANS_FILTERS: ParameterRequirement;
24
24
  export declare const LIST_PROJECT_TRACES: RouteRequirement;
25
25
  export declare const GET_SPANS_BY_ATTRIBUTE: ParameterRequirement;
26
26
  export declare const DATASET_UPLOAD_EXAMPLE_IDS: ParameterRequirement;
27
+ export declare const ADD_TRACE_NOTE_IDENTIFIER: ParameterRequirement;
28
+ export declare const ADD_SPAN_NOTE_IDENTIFIER: ParameterRequirement;
29
+ export declare const ADD_SESSION_NOTE_IDENTIFIER: ParameterRequirement;
27
30
  /**
28
31
  * Aggregate list of every known capability requirement.
29
32
  *
@@ -1 +1 @@
1
- {"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,WAAW,EAAE,gBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBAMpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBAMxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EAanD,CAAC"}
1
+ {"version":3,"file":"serverRequirements.d.ts","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,WAAW,EAAE,gBAKzB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,gBAK7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAKnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAK/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,gBAK5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,oBAMjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,oBAM/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAKjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,oBAMpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,oBAMxC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,oBAMvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,oBAMtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,oBAMzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,qBAAqB,EAgBnD,CAAC"}
@@ -13,7 +13,7 @@
13
13
  * function that uses it.
14
14
  */
15
15
  Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.ALL_REQUIREMENTS = exports.DATASET_UPLOAD_EXAMPLE_IDS = exports.GET_SPANS_BY_ATTRIBUTE = exports.LIST_PROJECT_TRACES = exports.GET_SPANS_FILTERS = exports.GET_SPANS_TRACE_IDS = exports.ADD_SESSION_NOTE = exports.ADD_TRACE_NOTE = exports.ANNOTATE_SESSIONS = exports.LIST_PROJECT_SESSIONS = exports.DELETE_SESSIONS = exports.DELETE_SESSION = exports.GET_SESSION = void 0;
16
+ exports.ALL_REQUIREMENTS = exports.ADD_SESSION_NOTE_IDENTIFIER = exports.ADD_SPAN_NOTE_IDENTIFIER = exports.ADD_TRACE_NOTE_IDENTIFIER = exports.DATASET_UPLOAD_EXAMPLE_IDS = exports.GET_SPANS_BY_ATTRIBUTE = exports.LIST_PROJECT_TRACES = exports.GET_SPANS_FILTERS = exports.GET_SPANS_TRACE_IDS = exports.ADD_SESSION_NOTE = exports.ADD_TRACE_NOTE = exports.ANNOTATE_SESSIONS = exports.LIST_PROJECT_SESSIONS = exports.DELETE_SESSIONS = exports.DELETE_SESSION = exports.GET_SESSION = void 0;
17
17
  exports.GET_SESSION = {
18
18
  kind: "route",
19
19
  method: "GET",
@@ -90,6 +90,27 @@ exports.DATASET_UPLOAD_EXAMPLE_IDS = {
90
90
  route: "POST /v1/datasets/upload",
91
91
  minServerVersion: [15, 0, 0],
92
92
  };
93
+ exports.ADD_TRACE_NOTE_IDENTIFIER = {
94
+ kind: "parameter",
95
+ parameterName: "identifier",
96
+ parameterLocation: "body",
97
+ route: "POST /v1/trace_notes",
98
+ minServerVersion: [15, 5, 0],
99
+ };
100
+ exports.ADD_SPAN_NOTE_IDENTIFIER = {
101
+ kind: "parameter",
102
+ parameterName: "identifier",
103
+ parameterLocation: "body",
104
+ route: "POST /v1/span_notes",
105
+ minServerVersion: [15, 5, 0],
106
+ };
107
+ exports.ADD_SESSION_NOTE_IDENTIFIER = {
108
+ kind: "parameter",
109
+ parameterName: "identifier",
110
+ parameterLocation: "body",
111
+ route: "POST /v1/session_notes",
112
+ minServerVersion: [15, 5, 0],
113
+ };
93
114
  /**
94
115
  * Aggregate list of every known capability requirement.
95
116
  *
@@ -109,5 +130,8 @@ exports.ALL_REQUIREMENTS = [
109
130
  exports.GET_SPANS_BY_ATTRIBUTE,
110
131
  exports.LIST_PROJECT_TRACES,
111
132
  exports.DATASET_UPLOAD_EXAMPLE_IDS,
133
+ exports.ADD_TRACE_NOTE_IDENTIFIER,
134
+ exports.ADD_SPAN_NOTE_IDENTIFIER,
135
+ exports.ADD_SESSION_NOTE_IDENTIFIER,
112
136
  ];
113
137
  //# sourceMappingURL=serverRequirements.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"serverRequirements.js","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAQU,QAAA,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,2BAA2B;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEW,QAAA,cAAc,GAAqB;IAC9C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,2BAA2B;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,eAAe,GAAqB;IAC/C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,qBAAqB;IAC3B,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,qBAAqB,GAAqB;IACrD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,oCAAoC;IAC1C,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEW,QAAA,iBAAiB,GAAqB;IACjD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,yBAAyB;IAC/B,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEW,QAAA,cAAc,GAAqB;IAC9C,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,iBAAiB;IACvB,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,gBAAgB,GAAqB;IAChD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,mBAAmB;IACzB,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,mBAAmB,GAAyB;IACvD,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,UAAU;IACzB,iBAAiB,EAAE,OAAO;IAC1B,KAAK,EAAE,6BAA6B;IACpC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEW,QAAA,iBAAiB,GAAyB;IACrD,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,WAAW;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,KAAK,EAAE,6BAA6B;IACpC,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,mBAAmB,GAAqB;IACnD,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,0CAA0C;IAChD,gBAAgB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEW,QAAA,sBAAsB,GAAyB;IAC1D,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,WAAW;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,KAAK,EAAE,6BAA6B;IACpC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEW,QAAA,0BAA0B,GAAyB;IAC9D,IAAI,EAAE,WAAW;IACjB,aAAa,EAAE,aAAa;IAC5B,iBAAiB,EAAE,MAAM;IACzB,KAAK,EAAE,0BAA0B;IACjC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACU,QAAA,gBAAgB,GAAqC;IAChE,mBAAW;IACX,sBAAc;IACd,uBAAe;IACf,6BAAqB;IACrB,yBAAiB;IACjB,sBAAc;IACd,wBAAgB;IAChB,2BAAmB;IACnB,yBAAiB;IACjB,8BAAsB;IACtB,2BAAmB;IACnB,kCAA0B;CAClB,CAAC"}
1
+ {"version":3,"file":"serverRequirements.js","sourceRoot":"","sources":["../../../src/constants/serverRequirements.ts"],"names":[],"mappings":"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"}
@@ -11,6 +11,13 @@ export interface SessionNote {
11
11
  * The note text to add to the session.
12
12
  */
13
13
  note: string;
14
+ /**
15
+ * Optional caller-supplied identifier. When non-empty, the note is upserted
16
+ * on `(sessionId, name='note', identifier)` — repeated calls with the same
17
+ * identifier overwrite the existing note. When omitted, the server stamps a
18
+ * unique `px-session-note:<uuid>` identifier so each call appends a new note.
19
+ */
20
+ identifier?: string;
14
21
  }
15
22
  /**
16
23
  * Parameters to add a session note.
@@ -21,8 +28,10 @@ export interface AddSessionNoteParams extends ClientFn {
21
28
  /**
22
29
  * Add a note to a session.
23
30
  *
24
- * Notes are a special type of annotation that allow multiple entries per session.
25
- * Each note gets a unique UUIDv4 identifier.
31
+ * When `sessionNote.identifier` is omitted, each call appends a new note with
32
+ * an auto-generated identifier. When `identifier` is non-empty, repeated calls
33
+ * with the same `(sessionId, name='note', identifier)` overwrite the existing
34
+ * note.
26
35
  *
27
36
  * @param params - The parameters to add a session note.
28
37
  * @returns The ID of the created note annotation.
@@ -1 +1 @@
1
- {"version":3,"file":"addSessionNote.d.ts","sourceRoot":"","sources":["../../../src/sessions/addSessionNote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,QAAQ;IACpD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,WAAW,GACZ,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBhD"}
1
+ {"version":3,"file":"addSessionNote.d.ts","sourceRoot":"","sources":["../../../src/sessions/addSessionNote.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,QAAQ;IACpD,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,WAAW,GACZ,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BhD"}
@@ -8,8 +8,10 @@ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
8
8
  /**
9
9
  * Add a note to a session.
10
10
  *
11
- * Notes are a special type of annotation that allow multiple entries per session.
12
- * Each note gets a unique UUIDv4 identifier.
11
+ * When `sessionNote.identifier` is omitted, each call appends a new note with
12
+ * an auto-generated identifier. When `identifier` is non-empty, repeated calls
13
+ * with the same `(sessionId, name='note', identifier)` overwrite the existing
14
+ * note.
13
15
  *
14
16
  * @param params - The parameters to add a session note.
15
17
  * @returns The ID of the created note annotation.
@@ -29,11 +31,18 @@ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
29
31
  async function addSessionNote({ client: _client, sessionNote, }) {
30
32
  const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
31
33
  await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.ADD_SESSION_NOTE });
34
+ if (sessionNote.identifier) {
35
+ await (0, serverVersionUtils_1.ensureServerCapability)({
36
+ client,
37
+ requirement: serverRequirements_1.ADD_SESSION_NOTE_IDENTIFIER,
38
+ });
39
+ }
32
40
  const { data, error } = await client.POST("/v1/session_notes", {
33
41
  body: {
34
42
  data: {
35
43
  session_id: sessionNote.sessionId.trim(),
36
44
  note: sessionNote.note,
45
+ identifier: sessionNote.identifier,
37
46
  },
38
47
  },
39
48
  });
@@ -1 +1 @@
1
- {"version":3,"file":"addSessionNote.js","sourceRoot":"","sources":["../../../src/sessions/addSessionNote.ts"],"names":[],"mappings":";;AAgDA,wCAyBC;AAzED,sCAAyC;AACzC,wEAAmE;AAEnE,0DAAwD;AACxD,oEAAqE;AAuBrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,WAAW,GACU;IACrB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,qCAAgB,EAAE,CAAC,CAAC;IAExE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC7D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE;gBACxC,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
1
+ {"version":3,"file":"addSessionNote.js","sourceRoot":"","sources":["../../../src/sessions/addSessionNote.ts"],"names":[],"mappings":";;AA4DA,wCAgCC;AA5FD,sCAAyC;AACzC,wEAGyC;AAEzC,0DAAwD;AACxD,oEAAqE;AA8BrE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACI,KAAK,UAAU,cAAc,CAAC,EACnC,MAAM,EAAE,OAAO,EACf,WAAW,GACU;IACrB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,qCAAgB,EAAE,CAAC,CAAC;IACxE,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAA,2CAAsB,EAAC;YAC3B,MAAM;YACN,WAAW,EAAE,gDAA2B;SACzC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;QAC7D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE;gBACxC,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,UAAU,EAAE,WAAW,CAAC,UAAU;aACnC;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
@@ -11,6 +11,13 @@ export interface SpanNote {
11
11
  * The note text to add to the span
12
12
  */
13
13
  note: string;
14
+ /**
15
+ * Optional caller-supplied identifier. When non-empty, the note is upserted
16
+ * on `(spanId, name='note', identifier)` — repeated calls with the same
17
+ * identifier overwrite the existing note. When omitted, the server stamps a
18
+ * unique `px-span-note:<uuid>` identifier so each call appends a new note.
19
+ */
20
+ identifier?: string;
14
21
  }
15
22
  /**
16
23
  * Parameters to add a span note
@@ -21,11 +28,10 @@ export interface AddSpanNoteParams extends ClientFn {
21
28
  /**
22
29
  * Add a note to a span.
23
30
  *
24
- * Notes are append-only: each call creates a new note with an auto-generated
25
- * UUIDv4 identifier, so multiple notes accumulate on the same span. Structured
26
- * annotations, by contrast, are keyed by `(name, spanId, identifier)` — to keep
27
- * multiple structured annotations with the same name on a span, supply distinct
28
- * identifiers; otherwise re-writing the same name overwrites the existing one.
31
+ * When `spanNote.identifier` is omitted, each call appends a new note with an
32
+ * auto-generated identifier. When `identifier` is non-empty, repeated calls
33
+ * with the same `(spanId, name='note', identifier)` overwrite the existing
34
+ * note.
29
35
  *
30
36
  * @param params - The parameters to add a span note
31
37
  * @returns The ID of the created note annotation
@@ -1 +1 @@
1
- {"version":3,"file":"addSpanNote.d.ts","sourceRoot":"","sources":["../../../src/spans/addSpanNote.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,WAAW,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,QAAQ,GACT,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB7C"}
1
+ {"version":3,"file":"addSpanNote.d.ts","sourceRoot":"","sources":["../../../src/spans/addSpanNote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,QAAQ,GACT,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B7C"}
@@ -2,15 +2,16 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.addSpanNote = addSpanNote;
4
4
  const client_1 = require("../client");
5
+ const serverRequirements_1 = require("../constants/serverRequirements");
5
6
  const apiErrorUtils_1 = require("../utils/apiErrorUtils");
7
+ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
6
8
  /**
7
9
  * Add a note to a span.
8
10
  *
9
- * Notes are append-only: each call creates a new note with an auto-generated
10
- * UUIDv4 identifier, so multiple notes accumulate on the same span. Structured
11
- * annotations, by contrast, are keyed by `(name, spanId, identifier)` — to keep
12
- * multiple structured annotations with the same name on a span, supply distinct
13
- * identifiers; otherwise re-writing the same name overwrites the existing one.
11
+ * When `spanNote.identifier` is omitted, each call appends a new note with an
12
+ * auto-generated identifier. When `identifier` is non-empty, repeated calls
13
+ * with the same `(spanId, name='note', identifier)` overwrite the existing
14
+ * note.
14
15
  *
15
16
  * @param params - The parameters to add a span note
16
17
  * @returns The ID of the created note annotation
@@ -27,11 +28,18 @@ const apiErrorUtils_1 = require("../utils/apiErrorUtils");
27
28
  */
28
29
  async function addSpanNote({ client: _client, spanNote, }) {
29
30
  const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
31
+ if (spanNote.identifier) {
32
+ await (0, serverVersionUtils_1.ensureServerCapability)({
33
+ client,
34
+ requirement: serverRequirements_1.ADD_SPAN_NOTE_IDENTIFIER,
35
+ });
36
+ }
30
37
  const { data, error } = await client.POST("/v1/span_notes", {
31
38
  body: {
32
39
  data: {
33
40
  span_id: spanNote.spanId.trim(),
34
41
  note: spanNote.note,
42
+ identifier: spanNote.identifier,
35
43
  },
36
44
  },
37
45
  });
@@ -1 +1 @@
1
- {"version":3,"file":"addSpanNote.js","sourceRoot":"","sources":["../../../src/spans/addSpanNote.ts"],"names":[],"mappings":";;AA+CA,kCAwBC;AAvED,sCAAyC;AAEzC,0DAAwD;AAuBxD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,WAAW,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,QAAQ,GACU;IAClB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IAEzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC1D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
1
+ {"version":3,"file":"addSpanNote.js","sourceRoot":"","sources":["../../../src/spans/addSpanNote.ts"],"names":[],"mappings":";;AAuDA,kCA+BC;AAtFD,sCAAyC;AACzC,wEAA2E;AAE3E,0DAAwD;AACxD,oEAAqE;AA8BrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,WAAW,CAAC,EAChC,MAAM,EAAE,OAAO,EACf,QAAQ,GACU;IAClB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAA,2CAAsB,EAAC;YAC3B,MAAM;YACN,WAAW,EAAE,6CAAwB;SACtC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;QAC1D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
@@ -9,7 +9,7 @@ export interface GetSpanAnnotationsParams extends ClientFn {
9
9
  project: ProjectIdentifier;
10
10
  /** One or more span IDs to fetch annotations for */
11
11
  spanIds: string[];
12
- /** Optional list of annotation names to include. If provided, only annotations with these names will be returned. 'note' annotations are excluded by default unless explicitly included in this list. */
12
+ /** Optional list of annotation names to include. If provided, only annotations with these names will be returned (allowlist). When omitted, the response includes every matching row regardless of name (no annotation names are excluded by default). */
13
13
  includeAnnotationNames?: string[];
14
14
  /** Optional list of annotation names to exclude from results. */
15
15
  excludeAnnotationNames?: string[];
@@ -1 +1 @@
1
- {"version":3,"file":"getSpanAnnotations.d.ts","sourceRoot":"","sources":["../../../src/spans/getSpanAnnotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACxD,+CAA+C;IAC/C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yMAAyM;IACzM,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,0BAA0B,GACpC,UAAU,CAAC,8BAA8B,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/E,UAAU,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC;CACtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,EACP,sBAAsB,EACtB,sBAAsB,EACtB,MAAM,EACN,KAAW,GACZ,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAwC9D"}
1
+ {"version":3,"file":"getSpanAnnotations.d.ts","sourceRoot":"","sources":["../../../src/spans/getSpanAnnotations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,QAAQ;IACxD,+CAA+C;IAC/C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0PAA0P;IAC1P,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,0BAA0B,GACpC,UAAU,CAAC,8BAA8B,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/E,UAAU,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC,aAAa,CAAC,CAAC;CACtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,MAAM,EAAE,OAAO,EACf,OAAO,EACP,OAAO,EACP,sBAAsB,EACtB,sBAAsB,EACtB,MAAM,EACN,KAAW,GACZ,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAwC9D"}
@@ -11,6 +11,13 @@ export interface TraceNote {
11
11
  * The note text to add to the trace.
12
12
  */
13
13
  note: string;
14
+ /**
15
+ * Optional caller-supplied identifier. When non-empty, the note is upserted
16
+ * on `(traceId, name='note', identifier)` — repeated calls with the same
17
+ * identifier overwrite the existing note. When omitted, the server stamps a
18
+ * unique `px-trace-note:<uuid>` identifier so each call appends a new note.
19
+ */
20
+ identifier?: string;
14
21
  }
15
22
  /**
16
23
  * Parameters to add a trace note.
@@ -21,11 +28,10 @@ export interface AddTraceNoteParams extends ClientFn {
21
28
  /**
22
29
  * Add a note to a trace.
23
30
  *
24
- * Notes are append-only: each call creates a new note with an auto-generated
25
- * UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured
26
- * annotations, by contrast, are keyed by `(name, traceId, identifier)` — to keep
27
- * multiple structured annotations with the same name on a trace, supply distinct
28
- * identifiers; otherwise re-writing the same name overwrites the existing one.
31
+ * When `traceNote.identifier` is omitted, each call appends a new note with an
32
+ * auto-generated identifier. When `identifier` is non-empty, repeated calls
33
+ * with the same `(traceId, name='note', identifier)` overwrite the existing
34
+ * note.
29
35
  *
30
36
  * @param params - The parameters to add a trace note.
31
37
  * @returns The ID of the created note annotation.
@@ -1 +1 @@
1
- {"version":3,"file":"addTraceNote.d.ts","sourceRoot":"","sources":["../../../src/traces/addTraceNote.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB9C"}
1
+ {"version":3,"file":"addTraceNote.d.ts","sourceRoot":"","sources":["../../../src/traces/addTraceNote.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,SAAS,GACV,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B9C"}
@@ -8,11 +8,10 @@ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
8
8
  /**
9
9
  * Add a note to a trace.
10
10
  *
11
- * Notes are append-only: each call creates a new note with an auto-generated
12
- * UUIDv4 identifier, so multiple notes accumulate on the same trace. Structured
13
- * annotations, by contrast, are keyed by `(name, traceId, identifier)` — to keep
14
- * multiple structured annotations with the same name on a trace, supply distinct
15
- * identifiers; otherwise re-writing the same name overwrites the existing one.
11
+ * When `traceNote.identifier` is omitted, each call appends a new note with an
12
+ * auto-generated identifier. When `identifier` is non-empty, repeated calls
13
+ * with the same `(traceId, name='note', identifier)` overwrite the existing
14
+ * note.
16
15
  *
17
16
  * @param params - The parameters to add a trace note.
18
17
  * @returns The ID of the created note annotation.
@@ -30,11 +29,18 @@ const serverVersionUtils_1 = require("../utils/serverVersionUtils");
30
29
  async function addTraceNote({ client: _client, traceNote, }) {
31
30
  const client = _client !== null && _client !== void 0 ? _client : (0, client_1.createClient)();
32
31
  await (0, serverVersionUtils_1.ensureServerCapability)({ client, requirement: serverRequirements_1.ADD_TRACE_NOTE });
32
+ if (traceNote.identifier) {
33
+ await (0, serverVersionUtils_1.ensureServerCapability)({
34
+ client,
35
+ requirement: serverRequirements_1.ADD_TRACE_NOTE_IDENTIFIER,
36
+ });
37
+ }
33
38
  const { data, error } = await client.POST("/v1/trace_notes", {
34
39
  body: {
35
40
  data: {
36
41
  trace_id: traceNote.traceId.trim(),
37
42
  note: traceNote.note,
43
+ identifier: traceNote.identifier,
38
44
  },
39
45
  },
40
46
  });
@@ -1 +1 @@
1
- {"version":3,"file":"addTraceNote.js","sourceRoot":"","sources":["../../../src/traces/addTraceNote.ts"],"names":[],"mappings":";;AAiDA,oCAyBC;AA1ED,sCAAyC;AACzC,wEAAiE;AAEjE,0DAAwD;AACxD,oEAAqE;AAuBrE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,YAAY,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,SAAS,GACU;IACnB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,mCAAc,EAAE,CAAC,CAAC;IAEtE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC3D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;gBAClC,IAAI,EAAE,SAAS,CAAC,IAAI;aACrB;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
1
+ {"version":3,"file":"addTraceNote.js","sourceRoot":"","sources":["../../../src/traces/addTraceNote.ts"],"names":[],"mappings":";;AA0DA,oCAgCC;AA1FD,sCAAyC;AACzC,wEAGyC;AAEzC,0DAAwD;AACxD,oEAAqE;AA8BrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,KAAK,UAAU,YAAY,CAAC,EACjC,MAAM,EAAE,OAAO,EACf,SAAS,GACU;IACnB,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,IAAA,qBAAY,GAAE,CAAC;IACzC,MAAM,IAAA,2CAAsB,EAAC,EAAE,MAAM,EAAE,WAAW,EAAE,mCAAc,EAAE,CAAC,CAAC;IACtE,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAA,2CAAsB,EAAC;YAC3B,MAAM;YACN,WAAW,EAAE,8CAAyB;SACvC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC3D,IAAI,EAAE;YACJ,IAAI,EAAE;gBACJ,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;gBAClC,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,UAAU,EAAE,SAAS,CAAC,UAAU;aACjC;SACF;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAA,8BAAc,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"formatPromptMessages.d.ts","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGhF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAc;;;;;;;mBA4DyosJ,uDAAsB;;;;;;;;;IAlBzrsJ"}
1
+ {"version":3,"file":"formatPromptMessages.d.ts","sourceRoot":"","sources":["../../../src/utils/formatPromptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGhF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAc;;;;;;;mBA4DurxJ,uDAAsB;;;;;;;;;IAlBvuxJ"}
@@ -1 +1 @@
1
- {"version":3,"file":"getPromptBySelector.d.ts","sourceRoot":"","sources":["../../../src/utils/getPromptBySelector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG;IACjD;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACP,EAAE,yBAAyB;;oBAkDuk6H,uDAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA0P,uDAAsB;qBAAoD,uDAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UADl96H"}
1
+ {"version":3,"file":"getPromptBySelector.d.ts","sourceRoot":"","sources":["../../../src/utils/getPromptBySelector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG;IACjD;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EAAE,OAAO,EACf,MAAM,GACP,EAAE,yBAAyB;;oBAkD2v9H,uDAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA0P,uDAAsB;qBAAoD,uDAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UADto+H"}