@getzep/zep-cloud 2.18.0 → 2.22.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 (48) hide show
  1. package/api/resources/document/client/Client.js +13 -13
  2. package/api/resources/graph/client/Client.js +7 -7
  3. package/api/resources/graph/resources/edge/client/Client.js +4 -4
  4. package/api/resources/graph/resources/episode/client/Client.js +5 -5
  5. package/api/resources/graph/resources/node/client/Client.js +5 -5
  6. package/api/resources/group/client/Client.js +6 -6
  7. package/api/resources/memory/client/Client.d.ts +1 -1
  8. package/api/resources/memory/client/Client.js +23 -23
  9. package/api/resources/memory/client/requests/AddMemoryRequest.d.ts +1 -1
  10. package/api/resources/user/client/Client.js +8 -8
  11. package/api/types/EntityEdge.d.ts +2 -0
  12. package/api/types/EntityNode.d.ts +2 -0
  13. package/api/types/Episode.d.ts +2 -1
  14. package/dist/api/resources/document/client/Client.js +13 -13
  15. package/dist/api/resources/graph/client/Client.js +7 -7
  16. package/dist/api/resources/graph/resources/edge/client/Client.js +4 -4
  17. package/dist/api/resources/graph/resources/episode/client/Client.js +5 -5
  18. package/dist/api/resources/graph/resources/node/client/Client.js +5 -5
  19. package/dist/api/resources/group/client/Client.js +6 -6
  20. package/dist/api/resources/memory/client/Client.d.ts +1 -1
  21. package/dist/api/resources/memory/client/Client.js +23 -23
  22. package/dist/api/resources/memory/client/requests/AddMemoryRequest.d.ts +1 -1
  23. package/dist/api/resources/user/client/Client.js +8 -8
  24. package/dist/api/types/EntityEdge.d.ts +2 -0
  25. package/dist/api/types/EntityNode.d.ts +2 -0
  26. package/dist/api/types/Episode.d.ts +2 -1
  27. package/dist/serialization/types/EntityEdge.d.ts +1 -0
  28. package/dist/serialization/types/EntityEdge.js +1 -0
  29. package/dist/serialization/types/EntityNode.d.ts +1 -0
  30. package/dist/serialization/types/EntityNode.js +1 -0
  31. package/dist/serialization/types/Episode.d.ts +1 -0
  32. package/dist/serialization/types/Episode.js +1 -0
  33. package/dist/version.d.ts +1 -1
  34. package/dist/version.js +1 -1
  35. package/examples/memory/memory_example.ts +1 -137
  36. package/package.json +1 -1
  37. package/reference.md +1 -1
  38. package/serialization/types/EntityEdge.d.ts +1 -0
  39. package/serialization/types/EntityEdge.js +1 -0
  40. package/serialization/types/EntityNode.d.ts +1 -0
  41. package/serialization/types/EntityNode.js +1 -0
  42. package/serialization/types/Episode.d.ts +1 -0
  43. package/serialization/types/Episode.js +1 -0
  44. package/version.d.ts +1 -1
  45. package/version.js +1 -1
  46. package/examples/documents/babbages_calculating_engine.txt +0 -3153
  47. package/examples/documents/index.ts +0 -188
  48. package/examples/memory/structured_data_extraction_example.ts +0 -34
@@ -14,6 +14,7 @@ export declare namespace EntityEdge {
14
14
  fact: string;
15
15
  invalid_at?: string | null;
16
16
  name: string;
17
+ score?: number | null;
17
18
  source_node_uuid: string;
18
19
  target_node_uuid: string;
19
20
  uuid: string;
@@ -46,6 +46,7 @@ exports.EntityEdge = core.serialization.object({
46
46
  fact: core.serialization.string(),
47
47
  invalidAt: core.serialization.property("invalid_at", core.serialization.string().optional()),
48
48
  name: core.serialization.string(),
49
+ score: core.serialization.number().optional(),
49
50
  sourceNodeUuid: core.serialization.property("source_node_uuid", core.serialization.string()),
50
51
  targetNodeUuid: core.serialization.property("target_node_uuid", core.serialization.string()),
51
52
  uuid: core.serialization.string(),
@@ -11,6 +11,7 @@ export declare namespace EntityNode {
11
11
  created_at: string;
12
12
  labels?: string[] | null;
13
13
  name: string;
14
+ score?: number | null;
14
15
  summary: string;
15
16
  uuid: string;
16
17
  }
@@ -43,6 +43,7 @@ exports.EntityNode = core.serialization.object({
43
43
  createdAt: core.serialization.property("created_at", core.serialization.string()),
44
44
  labels: core.serialization.list(core.serialization.string()).optional(),
45
45
  name: core.serialization.string(),
46
+ score: core.serialization.number().optional(),
46
47
  summary: core.serialization.string(),
47
48
  uuid: core.serialization.string(),
48
49
  });
@@ -14,6 +14,7 @@ export declare namespace Episode {
14
14
  processed?: boolean | null;
15
15
  role?: string | null;
16
16
  role_type?: RoleType.Raw | null;
17
+ score?: number | null;
17
18
  session_id?: string | null;
18
19
  source?: GraphDataType.Raw | null;
19
20
  source_description?: string | null;
@@ -46,6 +46,7 @@ exports.Episode = core.serialization.object({
46
46
  processed: core.serialization.boolean().optional(),
47
47
  role: core.serialization.string().optional(),
48
48
  roleType: core.serialization.property("role_type", RoleType_1.RoleType.optional()),
49
+ score: core.serialization.number().optional(),
49
50
  sessionId: core.serialization.property("session_id", core.serialization.string().optional()),
50
51
  source: GraphDataType_1.GraphDataType.optional(),
51
52
  sourceDescription: core.serialization.property("source_description", core.serialization.string().optional()),
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "2.18.0";
1
+ export declare const SDK_VERSION = "2.22.0";
package/dist/version.js CHANGED
@@ -1,4 +1,4 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SDK_VERSION = void 0;
4
- exports.SDK_VERSION = "2.18.0";
4
+ exports.SDK_VERSION = "2.22.0";
@@ -1,6 +1,6 @@
1
1
  import { v4 as uuidv4 } from "uuid";
2
2
  import { CreateUserRequest, Message, NotFoundError } from "../../src/api";
3
- import { ZepClient, zepFields } from "../../src";
3
+ import { ZepClient } from "../../src";
4
4
 
5
5
  // @ts-ignore
6
6
  import { history } from "./chat_shoe_store_history";
@@ -68,32 +68,6 @@ async function main() {
68
68
  console.debug("Got error:", error);
69
69
  }
70
70
 
71
- try {
72
- // Synthesize a question from most recent messages.
73
- // Useful for RAG apps.
74
- // This is faster than using an LLM chain.
75
- console.debug("\n---Synthesize a question from most recent messages");
76
- const { question } = await client.memory.synthesizeQuestion(sessionID, { lastNMessages: 3 });
77
- console.debug(`Question: ${question}`);
78
- } catch (error) {
79
- console.debug("Got error:", error);
80
- }
81
-
82
- try {
83
- // Classify the session.
84
- // Useful for semantic routing, filtering, and many other use cases.
85
- console.debug("\n---Classify the session");
86
- const classes = ["low spender <$50", "medium spender >=$50, <$100", "high spender >=$100", "unknown"];
87
- const classification = await client.memory.classifySession(sessionID, {
88
- name: "spender_category",
89
- classes,
90
- persist: true,
91
- });
92
- console.debug(`${classification.class} Classification Result: ${classification.label}`);
93
- } catch (error) {
94
- console.debug("Got error:", error);
95
- }
96
-
97
71
  console.log("Sleeping for 5 seconds to let background tasks complete...");
98
72
  sleep(5000); // Sleep for 5 seconds
99
73
  console.log("Done sleeping!");
@@ -169,116 +143,6 @@ async function main() {
169
143
  console.error("Got error:", error);
170
144
  }
171
145
  }
172
-
173
- // Search messages in memory
174
- try {
175
- const searchText = "Name some books that are about dystopian futures.";
176
- console.debug("Searching memory...", searchText);
177
-
178
- const { results: searchResults } = await client.memory.searchSessions({
179
- sessionIds: [sessionID],
180
- recordFilter: {
181
- where: {
182
- and: [
183
- {
184
- jsonpath: '$.system.entities[*] ? (@.Label == "WORK_OF_ART")',
185
- },
186
- {
187
- jsonpath: '$.system.entities[*] ? (@.Name like_regex "^parable*" flag "i")',
188
- },
189
- ],
190
- },
191
- },
192
- text: searchText,
193
- searchScope: "messages",
194
- });
195
-
196
- searchResults?.forEach((searchResult) => {
197
- console.debug("Search Result: ", JSON.stringify(searchResult.message));
198
- console.debug("Search Result Score: ", JSON.stringify(searchResult.score));
199
- });
200
- } catch (error) {
201
- if (error instanceof NotFoundError) {
202
- console.error("Session not found:", error.message);
203
- } else {
204
- console.error("Got error:", error);
205
- }
206
- }
207
-
208
- // Search messages in memory with MMR and lambda=0.6
209
- try {
210
- const searchText = "Name some books that are about dystopian futures.";
211
- console.debug("Searching memory with MMR...", searchText);
212
-
213
- const { results: searchResults } = await client.memory.searchSessions({
214
- sessionIds: [sessionID],
215
- text: searchText,
216
- searchType: "mmr",
217
- mmrLambda: 0.6,
218
- limit: 3,
219
- searchScope: "messages",
220
- });
221
-
222
- searchResults?.forEach((searchResult) => {
223
- console.debug("Search Result: ", JSON.stringify(searchResult.message));
224
- console.debug("Search Result Score: ", JSON.stringify(searchResult.score));
225
- });
226
- } catch (error) {
227
- if (error instanceof NotFoundError) {
228
- console.error("Session not found:", error.message);
229
- } else {
230
- console.error("Got error:", error);
231
- }
232
- }
233
-
234
- // Search summaries in memory with MMR and lambda=0.6
235
- try {
236
- const searchText = "Name some books that are about dystopian futures.";
237
- console.debug("Searching summaries with MMR...", searchText);
238
-
239
- const { results: searchResults } = await client.memory.searchSessions({
240
- sessionIds: [sessionID],
241
- text: searchText,
242
- searchScope: "summary",
243
- searchType: "mmr",
244
- mmrLambda: 0.6,
245
- limit: 3,
246
- });
247
-
248
- searchResults?.forEach((searchResult) => {
249
- console.debug("Search Result: ", JSON.stringify(searchResult.summary));
250
- console.debug("Search Result Score: ", JSON.stringify(searchResult.score));
251
- });
252
- } catch (error) {
253
- if (error instanceof NotFoundError) {
254
- console.error("Session not found:", error.message);
255
- } else {
256
- console.error("Got error:", error);
257
- }
258
- }
259
-
260
- try {
261
- const result = await client.memory.extract(
262
- sessionID,
263
- {
264
- shoeSize: zepFields.number("The Customer's shoe size"),
265
- budget: zepFields.number("The Customer's budget for shoe purchase"),
266
- favoriteBrand: zepFields.text("The Customer's favorite shoe brand. Just one brand, please!"),
267
- },
268
- { lastN: 20, validate: false, currentDateTime: new Date().toISOString() }
269
- );
270
- console.log("Data Extraction Result", result);
271
- } catch (error) {
272
- console.debug("Got error:", error);
273
- }
274
-
275
- // End session - this will trigger summarization and other background tasks on the completed session
276
- try {
277
- await client.memory.endSession(sessionID);
278
- console.debug("Ended session: ", sessionID);
279
- } catch (error) {
280
- console.debug("Got error:", error);
281
- }
282
146
  }
283
147
 
284
148
  main();
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getzep/zep-cloud",
3
- "version": "2.18.0",
3
+ "version": "2.22.0",
4
4
  "private": false,
5
5
  "repository": "https://github.com/getzep/zep-js",
6
6
  "description": "Zep: Fast, scalable building blocks for production LLM apps",
package/reference.md CHANGED
@@ -1822,7 +1822,7 @@ await client.memory.getSession("sessionId");
1822
1822
  <dl>
1823
1823
  <dd>
1824
1824
 
1825
- Update Session Metadata
1825
+ Update Session Metadata.
1826
1826
 
1827
1827
  </dd>
1828
1828
  </dl>
@@ -14,6 +14,7 @@ export declare namespace EntityEdge {
14
14
  fact: string;
15
15
  invalid_at?: string | null;
16
16
  name: string;
17
+ score?: number | null;
17
18
  source_node_uuid: string;
18
19
  target_node_uuid: string;
19
20
  uuid: string;
@@ -46,6 +46,7 @@ exports.EntityEdge = core.serialization.object({
46
46
  fact: core.serialization.string(),
47
47
  invalidAt: core.serialization.property("invalid_at", core.serialization.string().optional()),
48
48
  name: core.serialization.string(),
49
+ score: core.serialization.number().optional(),
49
50
  sourceNodeUuid: core.serialization.property("source_node_uuid", core.serialization.string()),
50
51
  targetNodeUuid: core.serialization.property("target_node_uuid", core.serialization.string()),
51
52
  uuid: core.serialization.string(),
@@ -11,6 +11,7 @@ export declare namespace EntityNode {
11
11
  created_at: string;
12
12
  labels?: string[] | null;
13
13
  name: string;
14
+ score?: number | null;
14
15
  summary: string;
15
16
  uuid: string;
16
17
  }
@@ -43,6 +43,7 @@ exports.EntityNode = core.serialization.object({
43
43
  createdAt: core.serialization.property("created_at", core.serialization.string()),
44
44
  labels: core.serialization.list(core.serialization.string()).optional(),
45
45
  name: core.serialization.string(),
46
+ score: core.serialization.number().optional(),
46
47
  summary: core.serialization.string(),
47
48
  uuid: core.serialization.string(),
48
49
  });
@@ -14,6 +14,7 @@ export declare namespace Episode {
14
14
  processed?: boolean | null;
15
15
  role?: string | null;
16
16
  role_type?: RoleType.Raw | null;
17
+ score?: number | null;
17
18
  session_id?: string | null;
18
19
  source?: GraphDataType.Raw | null;
19
20
  source_description?: string | null;
@@ -46,6 +46,7 @@ exports.Episode = core.serialization.object({
46
46
  processed: core.serialization.boolean().optional(),
47
47
  role: core.serialization.string().optional(),
48
48
  roleType: core.serialization.property("role_type", RoleType_1.RoleType.optional()),
49
+ score: core.serialization.number().optional(),
49
50
  sessionId: core.serialization.property("session_id", core.serialization.string().optional()),
50
51
  source: GraphDataType_1.GraphDataType.optional(),
51
52
  sourceDescription: core.serialization.property("source_description", core.serialization.string().optional()),
package/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "2.18.0";
1
+ export declare const SDK_VERSION = "2.22.0";
package/version.js CHANGED
@@ -1,4 +1,4 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SDK_VERSION = void 0;
4
- exports.SDK_VERSION = "2.18.0";
4
+ exports.SDK_VERSION = "2.22.0";