@getzep/zep-cloud 3.22.0 → 3.23.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 (98) hide show
  1. package/dist/cjs/Client.js +2 -2
  2. package/dist/cjs/api/resources/batch/client/requests/ApidataCreateBatchRequest.d.ts +8 -0
  3. package/dist/cjs/api/resources/graph/client/Client.d.ts +17 -1
  4. package/dist/cjs/api/resources/graph/client/Client.js +84 -1
  5. package/dist/cjs/api/resources/graph/client/requests/AddTripleRequest.d.ts +14 -2
  6. package/dist/cjs/api/resources/graph/client/requests/GraphSearchQuery.d.ts +3 -4
  7. package/dist/cjs/api/resources/thread/client/Client.d.ts +4 -2
  8. package/dist/cjs/api/resources/thread/client/Client.js +4 -2
  9. package/dist/cjs/api/resources/thread/client/requests/ThreadGetRequest.d.ts +1 -1
  10. package/dist/cjs/api/types/BatchItemDetail.d.ts +6 -0
  11. package/dist/cjs/api/types/BatchItemStatus.d.ts +2 -1
  12. package/dist/cjs/api/types/BatchItemStatus.js +1 -0
  13. package/dist/cjs/api/types/BatchProgress.d.ts +1 -0
  14. package/dist/cjs/api/types/BatchStatus.d.ts +2 -1
  15. package/dist/cjs/api/types/BatchStatus.js +1 -0
  16. package/dist/cjs/api/types/BatchSummary.d.ts +1 -0
  17. package/dist/cjs/api/types/DerivedNode.d.ts +16 -0
  18. package/dist/cjs/api/types/GraphSearchResponseMetadata.d.ts +7 -0
  19. package/dist/cjs/api/types/GraphSearchResponseMetadata.js +5 -0
  20. package/dist/cjs/api/types/GraphSearchResults.d.ts +1 -0
  21. package/dist/cjs/api/types/GraphitiSagaNode.d.ts +10 -1
  22. package/dist/cjs/api/types/ThreadSummary.d.ts +12 -1
  23. package/dist/cjs/api/types/index.d.ts +1 -0
  24. package/dist/cjs/api/types/index.js +1 -0
  25. package/dist/cjs/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.d.ts +2 -0
  26. package/dist/cjs/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.js +2 -0
  27. package/dist/cjs/serialization/types/BatchItemStatus.d.ts +1 -1
  28. package/dist/cjs/serialization/types/BatchItemStatus.js +1 -1
  29. package/dist/cjs/serialization/types/BatchProgress.d.ts +1 -0
  30. package/dist/cjs/serialization/types/BatchProgress.js +1 -0
  31. package/dist/cjs/serialization/types/BatchStatus.d.ts +1 -1
  32. package/dist/cjs/serialization/types/BatchStatus.js +10 -1
  33. package/dist/cjs/serialization/types/BatchSummary.d.ts +2 -0
  34. package/dist/cjs/serialization/types/BatchSummary.js +2 -0
  35. package/dist/cjs/serialization/types/DerivedNode.d.ts +3 -0
  36. package/dist/cjs/serialization/types/DerivedNode.js +3 -0
  37. package/dist/cjs/serialization/types/GraphSearchResponseMetadata.d.ts +12 -0
  38. package/dist/cjs/serialization/types/GraphSearchResponseMetadata.js +43 -0
  39. package/dist/cjs/serialization/types/GraphSearchResults.d.ts +2 -0
  40. package/dist/cjs/serialization/types/GraphSearchResults.js +2 -0
  41. package/dist/cjs/serialization/types/GraphitiSagaNode.d.ts +1 -0
  42. package/dist/cjs/serialization/types/GraphitiSagaNode.js +1 -0
  43. package/dist/cjs/serialization/types/ThreadSummary.d.ts +1 -0
  44. package/dist/cjs/serialization/types/ThreadSummary.js +1 -0
  45. package/dist/cjs/serialization/types/index.d.ts +1 -0
  46. package/dist/cjs/serialization/types/index.js +1 -0
  47. package/dist/cjs/version.d.ts +1 -1
  48. package/dist/cjs/version.js +1 -1
  49. package/dist/esm/Client.mjs +2 -2
  50. package/dist/esm/api/resources/batch/client/requests/ApidataCreateBatchRequest.d.mts +8 -0
  51. package/dist/esm/api/resources/graph/client/Client.d.mts +17 -1
  52. package/dist/esm/api/resources/graph/client/Client.mjs +84 -1
  53. package/dist/esm/api/resources/graph/client/requests/AddTripleRequest.d.mts +14 -2
  54. package/dist/esm/api/resources/graph/client/requests/GraphSearchQuery.d.mts +3 -4
  55. package/dist/esm/api/resources/thread/client/Client.d.mts +4 -2
  56. package/dist/esm/api/resources/thread/client/Client.mjs +4 -2
  57. package/dist/esm/api/resources/thread/client/requests/ThreadGetRequest.d.mts +1 -1
  58. package/dist/esm/api/types/BatchItemDetail.d.mts +6 -0
  59. package/dist/esm/api/types/BatchItemStatus.d.mts +2 -1
  60. package/dist/esm/api/types/BatchItemStatus.mjs +1 -0
  61. package/dist/esm/api/types/BatchProgress.d.mts +1 -0
  62. package/dist/esm/api/types/BatchStatus.d.mts +2 -1
  63. package/dist/esm/api/types/BatchStatus.mjs +1 -0
  64. package/dist/esm/api/types/BatchSummary.d.mts +1 -0
  65. package/dist/esm/api/types/DerivedNode.d.mts +16 -0
  66. package/dist/esm/api/types/GraphSearchResponseMetadata.d.mts +7 -0
  67. package/dist/esm/api/types/GraphSearchResponseMetadata.mjs +4 -0
  68. package/dist/esm/api/types/GraphSearchResults.d.mts +1 -0
  69. package/dist/esm/api/types/GraphitiSagaNode.d.mts +10 -1
  70. package/dist/esm/api/types/ThreadSummary.d.mts +12 -1
  71. package/dist/esm/api/types/index.d.mts +1 -0
  72. package/dist/esm/api/types/index.mjs +1 -0
  73. package/dist/esm/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.d.mts +2 -0
  74. package/dist/esm/serialization/resources/batch/client/requests/ApidataCreateBatchRequest.mjs +2 -0
  75. package/dist/esm/serialization/types/BatchItemStatus.d.mts +1 -1
  76. package/dist/esm/serialization/types/BatchItemStatus.mjs +1 -1
  77. package/dist/esm/serialization/types/BatchProgress.d.mts +1 -0
  78. package/dist/esm/serialization/types/BatchProgress.mjs +1 -0
  79. package/dist/esm/serialization/types/BatchStatus.d.mts +1 -1
  80. package/dist/esm/serialization/types/BatchStatus.mjs +10 -1
  81. package/dist/esm/serialization/types/BatchSummary.d.mts +2 -0
  82. package/dist/esm/serialization/types/BatchSummary.mjs +2 -0
  83. package/dist/esm/serialization/types/DerivedNode.d.mts +3 -0
  84. package/dist/esm/serialization/types/DerivedNode.mjs +3 -0
  85. package/dist/esm/serialization/types/GraphSearchResponseMetadata.d.mts +12 -0
  86. package/dist/esm/serialization/types/GraphSearchResponseMetadata.mjs +7 -0
  87. package/dist/esm/serialization/types/GraphSearchResults.d.mts +2 -0
  88. package/dist/esm/serialization/types/GraphSearchResults.mjs +2 -0
  89. package/dist/esm/serialization/types/GraphitiSagaNode.d.mts +1 -0
  90. package/dist/esm/serialization/types/GraphitiSagaNode.mjs +1 -0
  91. package/dist/esm/serialization/types/ThreadSummary.d.mts +1 -0
  92. package/dist/esm/serialization/types/ThreadSummary.mjs +1 -0
  93. package/dist/esm/serialization/types/index.d.mts +1 -0
  94. package/dist/esm/serialization/types/index.mjs +1 -0
  95. package/dist/esm/version.d.mts +1 -1
  96. package/dist/esm/version.mjs +1 -1
  97. package/package.json +1 -1
  98. package/reference.md +70 -3
@@ -51,8 +51,8 @@ class ZepClient {
51
51
  this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
52
52
  "X-Fern-Language": "JavaScript",
53
53
  "X-Fern-SDK-Name": "zep-cloud",
54
- "X-Fern-SDK-Version": "3.22.0",
55
- "User-Agent": "zep-cloud/3.22.0",
54
+ "X-Fern-SDK-Version": "3.23.0",
55
+ "User-Agent": "zep-cloud/3.23.0",
56
56
  "X-Fern-Runtime": core.RUNTIME.type,
57
57
  "X-Fern-Runtime-Version": core.RUNTIME.version,
58
58
  }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -1,10 +1,18 @@
1
1
  /**
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
+ import * as Zep from "../../../../index.js";
4
5
  /**
5
6
  * @example
6
7
  * {}
7
8
  */
8
9
  export interface ApidataCreateBatchRequest {
10
+ /**
11
+ * Optional list of message role types to skip during graph ingestion for
12
+ * thread_message items in this batch. The messages are still stored and
13
+ * retained as context, but no graph extraction is performed for them.
14
+ * Has no effect on graph_episode items.
15
+ */
16
+ ignoreRoles?: Zep.RoleType[];
9
17
  metadata?: Record<string, unknown>;
10
18
  }
@@ -147,7 +147,9 @@ export declare class Graph {
147
147
  add(request: Zep.AddDataRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Episode>;
148
148
  private __add;
149
149
  /**
150
- * Add data to the graph in batch mode. Episodes are processed sequentially in the order provided.
150
+ * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*`) instead.
151
+ *
152
+ * Adds data to the graph in batch mode, processing episodes concurrently.
151
153
  *
152
154
  * @param {Zep.AddDataBatchRequest} request
153
155
  * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
@@ -312,6 +314,20 @@ export declare class Graph {
312
314
  */
313
315
  update(graphId: string, request?: Zep.UpdateGraphRequest, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.Graph>;
314
316
  private __update;
317
+ /**
318
+ * Hints Zep to warm a graph for low-latency search
319
+ *
320
+ * @param {string} graphId - The graph_id of the graph to warm.
321
+ * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
322
+ *
323
+ * @throws {@link Zep.NotFoundError}
324
+ * @throws {@link Zep.InternalServerError}
325
+ *
326
+ * @example
327
+ * await client.graph.warm("graphId")
328
+ */
329
+ warm(graphId: string, requestOptions?: Graph.RequestOptions): core.HttpResponsePromise<Zep.SuccessResponse>;
330
+ private __warm;
315
331
  protected _getCustomAuthorizationHeaders(): Promise<{
316
332
  Authorization: string;
317
333
  }>;
@@ -633,7 +633,9 @@ class Graph {
633
633
  });
634
634
  }
635
635
  /**
636
- * Add data to the graph in batch mode. Episodes are processed sequentially in the order provided.
636
+ * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*`) instead.
637
+ *
638
+ * Adds data to the graph in batch mode, processing episodes concurrently.
637
639
  *
638
640
  * @param {Zep.AddDataBatchRequest} request
639
641
  * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
@@ -1506,6 +1508,87 @@ class Graph {
1506
1508
  }
1507
1509
  });
1508
1510
  }
1511
+ /**
1512
+ * Hints Zep to warm a graph for low-latency search
1513
+ *
1514
+ * @param {string} graphId - The graph_id of the graph to warm.
1515
+ * @param {Graph.RequestOptions} requestOptions - Request-specific configuration.
1516
+ *
1517
+ * @throws {@link Zep.NotFoundError}
1518
+ * @throws {@link Zep.InternalServerError}
1519
+ *
1520
+ * @example
1521
+ * await client.graph.warm("graphId")
1522
+ */
1523
+ warm(graphId, requestOptions) {
1524
+ return core.HttpResponsePromise.fromPromise(this.__warm(graphId, requestOptions));
1525
+ }
1526
+ __warm(graphId, requestOptions) {
1527
+ return __awaiter(this, void 0, void 0, function* () {
1528
+ var _a, _b, _c, _d;
1529
+ const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
1530
+ url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.ZepEnvironment.Default, `graph/${encodeURIComponent(graphId)}/warm`),
1531
+ method: "GET",
1532
+ headers: (0, headers_js_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
1533
+ timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
1534
+ maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
1535
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
1536
+ });
1537
+ if (_response.ok) {
1538
+ return {
1539
+ data: serializers.SuccessResponse.parseOrThrow(_response.body, {
1540
+ unrecognizedObjectKeys: "passthrough",
1541
+ allowUnrecognizedUnionMembers: true,
1542
+ allowUnrecognizedEnumValues: true,
1543
+ skipValidation: true,
1544
+ breadcrumbsPrefix: ["response"],
1545
+ }),
1546
+ rawResponse: _response.rawResponse,
1547
+ };
1548
+ }
1549
+ if (_response.error.reason === "status-code") {
1550
+ switch (_response.error.statusCode) {
1551
+ case 404:
1552
+ throw new Zep.NotFoundError(serializers.ApiError.parseOrThrow(_response.error.body, {
1553
+ unrecognizedObjectKeys: "passthrough",
1554
+ allowUnrecognizedUnionMembers: true,
1555
+ allowUnrecognizedEnumValues: true,
1556
+ skipValidation: true,
1557
+ breadcrumbsPrefix: ["response"],
1558
+ }), _response.rawResponse);
1559
+ case 500:
1560
+ throw new Zep.InternalServerError(serializers.ApiError.parseOrThrow(_response.error.body, {
1561
+ unrecognizedObjectKeys: "passthrough",
1562
+ allowUnrecognizedUnionMembers: true,
1563
+ allowUnrecognizedEnumValues: true,
1564
+ skipValidation: true,
1565
+ breadcrumbsPrefix: ["response"],
1566
+ }), _response.rawResponse);
1567
+ default:
1568
+ throw new errors.ZepError({
1569
+ statusCode: _response.error.statusCode,
1570
+ body: _response.error.body,
1571
+ rawResponse: _response.rawResponse,
1572
+ });
1573
+ }
1574
+ }
1575
+ switch (_response.error.reason) {
1576
+ case "non-json":
1577
+ throw new errors.ZepError({
1578
+ statusCode: _response.error.statusCode,
1579
+ body: _response.error.rawBody,
1580
+ rawResponse: _response.rawResponse,
1581
+ });
1582
+ case "timeout":
1583
+ throw new errors.ZepTimeoutError("Timeout exceeded when calling GET /graph/{graphId}/warm.");
1584
+ case "unknown":
1585
+ throw new errors.ZepError({
1586
+ message: _response.error.errorMessage,
1587
+ rawResponse: _response.rawResponse,
1588
+ });
1589
+ }
1590
+ });
1591
+ }
1509
1592
  _getCustomAuthorizationHeaders() {
1510
1593
  return __awaiter(this, void 0, void 0, function* () {
1511
1594
  var _a;
@@ -37,7 +37,13 @@ export interface AddTripleRequest {
37
37
  * Nested objects and arrays are not allowed.
38
38
  */
39
39
  sourceNodeAttributes?: Record<string, unknown>;
40
- /** The labels for the source node */
40
+ /**
41
+ * The labels for the source node. At most one entity-type label may be
42
+ * provided so that manually-added triples remain consistent with automatic
43
+ * episode extraction, which assigns one best-match entity type per node.
44
+ * The base "Entity" label is added implicitly by the graph layer on save
45
+ * and does not need to be supplied here.
46
+ */
41
47
  sourceNodeLabels?: string[];
42
48
  /** The name of the source node to add */
43
49
  sourceNodeName?: string;
@@ -50,7 +56,13 @@ export interface AddTripleRequest {
50
56
  * Nested objects and arrays are not allowed.
51
57
  */
52
58
  targetNodeAttributes?: Record<string, unknown>;
53
- /** The labels for the target node */
59
+ /**
60
+ * The labels for the target node. At most one entity-type label may be
61
+ * provided so that manually-added triples remain consistent with automatic
62
+ * episode extraction, which assigns one best-match entity type per node.
63
+ * The base "Entity" label is added implicitly by the graph layer on save
64
+ * and does not need to be supplied here.
65
+ */
54
66
  targetNodeLabels?: string[];
55
67
  /** The name of the target node to add */
56
68
  targetNodeName?: string;
@@ -15,7 +15,7 @@ export interface GraphSearchQuery {
15
15
  centerNodeUuid?: string;
16
16
  /** The graph_id to search in. When searching user graph, please use user_id instead. */
17
17
  graphId?: string;
18
- /** The maximum number of facts to retrieve. Defaults to 10. Limited to 50. */
18
+ /** The maximum number of facts to retrieve for non-auto scopes. Defaults to 10. Limited to 50. Ignored when scope=auto. */
19
19
  limit?: number;
20
20
  /** Maximum total characters across all selected results when scope=auto. Defaults to 2500. Limited to 50000. */
21
21
  maxCharacters?: number;
@@ -24,9 +24,8 @@ export interface GraphSearchQuery {
24
24
  /** The string to search for (required) */
25
25
  query: string;
26
26
  /**
27
- * Defaults to RRF. When scope=auto, this only affects graph-service retrieval
28
- * shape for graph facts, observations, and thread summaries; source-episode
29
- * retrieval uses RRF, and auto search applies its own internal rerank after retrieval.
27
+ * Defaults to RRF. Ignored when scope=auto except node_distance and episode_mentions are rejected;
28
+ * auto search always uses RRF retrieval and applies its own internal rerank after retrieval.
30
29
  */
31
30
  reranker?: Zep.Reranker;
32
31
  /**
@@ -111,7 +111,7 @@ export declare class Thread {
111
111
  * @example
112
112
  * await client.thread.get("threadId", {
113
113
  * limit: 1,
114
- * cursor: 1,
114
+ * cursor: 1000000,
115
115
  * lastn: 1
116
116
  * })
117
117
  */
@@ -137,7 +137,9 @@ export declare class Thread {
137
137
  addMessages(threadId: string, request: Zep.AddThreadMessagesRequest, requestOptions?: Thread.RequestOptions): core.HttpResponsePromise<Zep.AddThreadMessagesResponse>;
138
138
  private __addMessages;
139
139
  /**
140
- * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
140
+ * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*` with `type: "thread_message"`) instead.
141
+ *
142
+ * Adds messages to a thread in batch mode, processing messages concurrently.
141
143
  *
142
144
  * @param {string} threadId - The ID of the thread to which messages should be added.
143
145
  * @param {Zep.AddThreadMessagesRequest} request
@@ -424,7 +424,7 @@ class Thread {
424
424
  * @example
425
425
  * await client.thread.get("threadId", {
426
426
  * limit: 1,
427
- * cursor: 1,
427
+ * cursor: 1000000,
428
428
  * lastn: 1
429
429
  * })
430
430
  */
@@ -594,7 +594,9 @@ class Thread {
594
594
  });
595
595
  }
596
596
  /**
597
- * Add messages to a thread in batch mode. This will process messages concurrently, which is useful for data migrations.
597
+ * Deprecated. Use the [Batch API](/adding-batch-data) (`client.batch.*` with `type: "thread_message"`) instead.
598
+ *
599
+ * Adds messages to a thread in batch mode, processing messages concurrently.
598
600
  *
599
601
  * @param {string} threadId - The ID of the thread to which messages should be added.
600
602
  * @param {Zep.AddThreadMessagesRequest} request
@@ -5,7 +5,7 @@
5
5
  * @example
6
6
  * {
7
7
  * limit: 1,
8
- * cursor: 1,
8
+ * cursor: 1000000,
9
9
  * lastn: 1
10
10
  * }
11
11
  */
@@ -4,6 +4,12 @@
4
4
  import * as Zep from "../index.js";
5
5
  export interface BatchItemDetail {
6
6
  createdAt?: string;
7
+ /**
8
+ * EpisodeUUID is the UUID of the episode that will be (or has been) created
9
+ * for this batch item. Populated for every item kind and always equal to
10
+ * SourceUUID — the underlying source row's UUID is reused as the episode
11
+ * UUID during processing.
12
+ */
7
13
  episodeUuid?: string;
8
14
  error?: Record<string, unknown>;
9
15
  graphId?: string;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
- export type BatchItemStatus = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped";
4
+ export type BatchItemStatus = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped" | "canceled";
5
5
  export declare const BatchItemStatus: {
6
6
  readonly Pending: "pending";
7
7
  readonly Queued: "queued";
@@ -9,4 +9,5 @@ export declare const BatchItemStatus: {
9
9
  readonly Succeeded: "succeeded";
10
10
  readonly Failed: "failed";
11
11
  readonly Skipped: "skipped";
12
+ readonly Canceled: "canceled";
12
13
  };
@@ -11,4 +11,5 @@ exports.BatchItemStatus = {
11
11
  Succeeded: "succeeded",
12
12
  Failed: "failed",
13
13
  Skipped: "skipped",
14
+ Canceled: "canceled",
14
15
  };
@@ -2,6 +2,7 @@
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
4
  export interface BatchProgress {
5
+ canceledItems?: number;
5
6
  failedItems?: number;
6
7
  percentComplete?: number;
7
8
  processingItems?: number;
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * This file was auto-generated by Fern from our API Definition.
3
3
  */
4
- export type BatchStatus = "draft" | "invalid" | "queued" | "processing" | "succeeded" | "partial" | "failed";
4
+ export type BatchStatus = "draft" | "invalid" | "queued" | "processing" | "succeeded" | "partial" | "failed" | "canceled";
5
5
  export declare const BatchStatus: {
6
6
  readonly Draft: "draft";
7
7
  readonly Invalid: "invalid";
@@ -10,4 +10,5 @@ export declare const BatchStatus: {
10
10
  readonly Succeeded: "succeeded";
11
11
  readonly Partial: "partial";
12
12
  readonly Failed: "failed";
13
+ readonly Canceled: "canceled";
13
14
  };
@@ -12,4 +12,5 @@ exports.BatchStatus = {
12
12
  Succeeded: "succeeded",
13
13
  Partial: "partial",
14
14
  Failed: "failed",
15
+ Canceled: "canceled",
15
16
  };
@@ -6,6 +6,7 @@ export interface BatchSummary {
6
6
  batchId?: string;
7
7
  completedAt?: string;
8
8
  createdAt?: string;
9
+ ignoreRoles?: Zep.RoleType[];
9
10
  itemCount?: number;
10
11
  metadata?: Record<string, unknown>;
11
12
  processedAt?: string;
@@ -6,10 +6,21 @@ export interface DerivedNode {
6
6
  attributes?: Record<string, unknown>;
7
7
  /** Creation time of the node */
8
8
  createdAt: string;
9
+ /**
10
+ * EndAt is the close timestamp of the evidence window. Set when the
11
+ * underlying pattern is no longer supported (closed observations);
12
+ * nil for active observations.
13
+ */
14
+ endAt?: string;
9
15
  /** Episode UUIDs that support this observation. Only populated for observation nodes in web API responses. */
10
16
  episodeIds?: string[];
11
17
  /** Labels associated with the node */
12
18
  labels?: string[];
19
+ /**
20
+ * LatestEvidenceAt is the most recent source-episode timestamp from
21
+ * which this observation drew evidence.
22
+ */
23
+ latestEvidenceAt?: string;
13
24
  /** Name of the node */
14
25
  name: string;
15
26
  /**
@@ -21,6 +32,11 @@ export interface DerivedNode {
21
32
  score?: number;
22
33
  /** SelectionRank is the global cross-scope rank assigned by auto scope selection. */
23
34
  selectionRank?: number;
35
+ /**
36
+ * StartAt is the earliest source-episode timestamp from which this
37
+ * observation was derived. Only populated for observation nodes.
38
+ */
39
+ startAt?: string;
24
40
  /** Region summary of member nodes */
25
41
  summary?: string;
26
42
  /** UUID of the node */
@@ -0,0 +1,7 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ export interface GraphSearchResponseMetadata {
5
+ /** Server-side processing latency in milliseconds. */
6
+ serverLatencyMs?: number;
7
+ }
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ /**
3
+ * This file was auto-generated by Fern from our API Definition.
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -8,5 +8,6 @@ export interface GraphSearchResults {
8
8
  episodes?: Zep.Episode[];
9
9
  nodes?: Zep.EntityNode[];
10
10
  observations?: Zep.DerivedNode[];
11
+ response?: Zep.GraphSearchResponseMetadata;
11
12
  threadSummaries?: Zep.GraphitiSagaNode[];
12
13
  }
@@ -6,8 +6,17 @@ export interface GraphitiSagaNode {
6
6
  createdAt: string;
7
7
  /** Labels associated with the node */
8
8
  labels?: string[];
9
- /** Timestamp of the most recent summary update. */
9
+ /**
10
+ * Wall-clock timestamp of the most recent summary update. Used internally
11
+ * as the watermark for filtering new episodes by ingestion time.
12
+ */
10
13
  lastSummarizedAt?: string;
14
+ /**
15
+ * Maximum episode reference time (valid_at) covered by the most recent
16
+ * summary. Use this field — not LastSummarizedAt — when answering "how
17
+ * recent is this summary's content in event-time?".
18
+ */
19
+ lastSummarizedEpisodeValidAt?: string;
11
20
  /** Name of the node */
12
21
  name: string;
13
22
  /**
@@ -4,8 +4,19 @@
4
4
  export interface ThreadSummary {
5
5
  /** CreatedAt is when the summary node was first created. */
6
6
  createdAt?: string;
7
- /** LastSummarizedAt is the timestamp of the most recent summary update. */
7
+ /**
8
+ * LastSummarizedAt is the wall-clock timestamp of the most recent
9
+ * summary update. This is an ingestion-time watermark; for the
10
+ * event-time recency of the summary's content, use
11
+ * LastSummarizedEpisodeValidAt instead.
12
+ */
8
13
  lastSummarizedAt?: string;
14
+ /**
15
+ * LastSummarizedEpisodeValidAt is the maximum episode reference time
16
+ * (valid_at) covered by the most recent summary. Use this when
17
+ * answering "how recent is this summary's content in event-time?".
18
+ */
19
+ lastSummarizedEpisodeValidAt?: string;
9
20
  /** Summary is the incremental summary content. */
10
21
  summary?: string;
11
22
  /**
@@ -31,6 +31,7 @@ export * from "./EpisodeResponse.js";
31
31
  export * from "./GraphListResponse.js";
32
32
  export * from "./GraphNodesRequest.js";
33
33
  export * from "./GraphObservationsRequest.js";
34
+ export * from "./GraphSearchResponseMetadata.js";
34
35
  export * from "./GraphSearchResults.js";
35
36
  export * from "./GraphThreadSummariesRequest.js";
36
37
  export * from "./HubDetectConfig.js";
@@ -47,6 +47,7 @@ __exportStar(require("./EpisodeResponse.js"), exports);
47
47
  __exportStar(require("./GraphListResponse.js"), exports);
48
48
  __exportStar(require("./GraphNodesRequest.js"), exports);
49
49
  __exportStar(require("./GraphObservationsRequest.js"), exports);
50
+ __exportStar(require("./GraphSearchResponseMetadata.js"), exports);
50
51
  __exportStar(require("./GraphSearchResults.js"), exports);
51
52
  __exportStar(require("./GraphThreadSummariesRequest.js"), exports);
52
53
  __exportStar(require("./HubDetectConfig.js"), exports);
@@ -4,9 +4,11 @@
4
4
  import * as serializers from "../../../../index.js";
5
5
  import * as Zep from "../../../../../api/index.js";
6
6
  import * as core from "../../../../../core/index.js";
7
+ import { RoleType } from "../../../../types/RoleType.js";
7
8
  export declare const ApidataCreateBatchRequest: core.serialization.Schema<serializers.ApidataCreateBatchRequest.Raw, Zep.ApidataCreateBatchRequest>;
8
9
  export declare namespace ApidataCreateBatchRequest {
9
10
  interface Raw {
11
+ ignore_roles?: RoleType.Raw[] | null;
10
12
  metadata?: Record<string, unknown> | null;
11
13
  }
12
14
  }
@@ -38,6 +38,8 @@ var __importStar = (this && this.__importStar) || (function () {
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.ApidataCreateBatchRequest = void 0;
40
40
  const core = __importStar(require("../../../../../core/index.js"));
41
+ const RoleType_js_1 = require("../../../../types/RoleType.js");
41
42
  exports.ApidataCreateBatchRequest = core.serialization.object({
43
+ ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType_js_1.RoleType).optional()),
42
44
  metadata: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
43
45
  });
@@ -6,5 +6,5 @@ import * as Zep from "../../api/index.js";
6
6
  import * as core from "../../core/index.js";
7
7
  export declare const BatchItemStatus: core.serialization.Schema<serializers.BatchItemStatus.Raw, Zep.BatchItemStatus>;
8
8
  export declare namespace BatchItemStatus {
9
- type Raw = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped";
9
+ type Raw = "pending" | "queued" | "processing" | "succeeded" | "failed" | "skipped" | "canceled";
10
10
  }
@@ -38,4 +38,4 @@ var __importStar = (this && this.__importStar) || (function () {
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.BatchItemStatus = void 0;
40
40
  const core = __importStar(require("../../core/index.js"));
41
- exports.BatchItemStatus = core.serialization.enum_(["pending", "queued", "processing", "succeeded", "failed", "skipped"]);
41
+ exports.BatchItemStatus = core.serialization.enum_(["pending", "queued", "processing", "succeeded", "failed", "skipped", "canceled"]);
@@ -7,6 +7,7 @@ import * as core from "../../core/index.js";
7
7
  export declare const BatchProgress: core.serialization.ObjectSchema<serializers.BatchProgress.Raw, Zep.BatchProgress>;
8
8
  export declare namespace BatchProgress {
9
9
  interface Raw {
10
+ canceled_items?: number | null;
10
11
  failed_items?: number | null;
11
12
  percent_complete?: number | null;
12
13
  processing_items?: number | null;
@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.BatchProgress = void 0;
40
40
  const core = __importStar(require("../../core/index.js"));
41
41
  exports.BatchProgress = core.serialization.object({
42
+ canceledItems: core.serialization.property("canceled_items", core.serialization.number().optional()),
42
43
  failedItems: core.serialization.property("failed_items", core.serialization.number().optional()),
43
44
  percentComplete: core.serialization.property("percent_complete", core.serialization.number().optional()),
44
45
  processingItems: core.serialization.property("processing_items", core.serialization.number().optional()),
@@ -6,5 +6,5 @@ import * as Zep from "../../api/index.js";
6
6
  import * as core from "../../core/index.js";
7
7
  export declare const BatchStatus: core.serialization.Schema<serializers.BatchStatus.Raw, Zep.BatchStatus>;
8
8
  export declare namespace BatchStatus {
9
- type Raw = "draft" | "invalid" | "queued" | "processing" | "succeeded" | "partial" | "failed";
9
+ type Raw = "draft" | "invalid" | "queued" | "processing" | "succeeded" | "partial" | "failed" | "canceled";
10
10
  }
@@ -38,4 +38,13 @@ var __importStar = (this && this.__importStar) || (function () {
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.BatchStatus = void 0;
40
40
  const core = __importStar(require("../../core/index.js"));
41
- exports.BatchStatus = core.serialization.enum_(["draft", "invalid", "queued", "processing", "succeeded", "partial", "failed"]);
41
+ exports.BatchStatus = core.serialization.enum_([
42
+ "draft",
43
+ "invalid",
44
+ "queued",
45
+ "processing",
46
+ "succeeded",
47
+ "partial",
48
+ "failed",
49
+ "canceled",
50
+ ]);
@@ -4,6 +4,7 @@
4
4
  import * as serializers from "../index.js";
5
5
  import * as Zep from "../../api/index.js";
6
6
  import * as core from "../../core/index.js";
7
+ import { RoleType } from "./RoleType.js";
7
8
  import { BatchProgress } from "./BatchProgress.js";
8
9
  import { BatchStatus } from "./BatchStatus.js";
9
10
  export declare const BatchSummary: core.serialization.ObjectSchema<serializers.BatchSummary.Raw, Zep.BatchSummary>;
@@ -12,6 +13,7 @@ export declare namespace BatchSummary {
12
13
  batch_id?: string | null;
13
14
  completed_at?: string | null;
14
15
  created_at?: string | null;
16
+ ignore_roles?: RoleType.Raw[] | null;
15
17
  item_count?: number | null;
16
18
  metadata?: Record<string, unknown> | null;
17
19
  processed_at?: string | null;
@@ -38,12 +38,14 @@ var __importStar = (this && this.__importStar) || (function () {
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.BatchSummary = void 0;
40
40
  const core = __importStar(require("../../core/index.js"));
41
+ const RoleType_js_1 = require("./RoleType.js");
41
42
  const BatchProgress_js_1 = require("./BatchProgress.js");
42
43
  const BatchStatus_js_1 = require("./BatchStatus.js");
43
44
  exports.BatchSummary = core.serialization.object({
44
45
  batchId: core.serialization.property("batch_id", core.serialization.string().optional()),
45
46
  completedAt: core.serialization.property("completed_at", core.serialization.string().optional()),
46
47
  createdAt: core.serialization.property("created_at", core.serialization.string().optional()),
48
+ ignoreRoles: core.serialization.property("ignore_roles", core.serialization.list(RoleType_js_1.RoleType).optional()),
47
49
  itemCount: core.serialization.property("item_count", core.serialization.number().optional()),
48
50
  metadata: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
49
51
  processedAt: core.serialization.property("processed_at", core.serialization.string().optional()),
@@ -9,12 +9,15 @@ export declare namespace DerivedNode {
9
9
  interface Raw {
10
10
  attributes?: Record<string, unknown> | null;
11
11
  created_at: string;
12
+ end_at?: string | null;
12
13
  episode_ids?: string[] | null;
13
14
  labels?: string[] | null;
15
+ latest_evidence_at?: string | null;
14
16
  name: string;
15
17
  relevance?: number | null;
16
18
  score?: number | null;
17
19
  selection_rank?: number | null;
20
+ start_at?: string | null;
18
21
  summary?: string | null;
19
22
  uuid: string;
20
23
  }
@@ -41,12 +41,15 @@ const core = __importStar(require("../../core/index.js"));
41
41
  exports.DerivedNode = core.serialization.object({
42
42
  attributes: core.serialization.record(core.serialization.string(), core.serialization.unknown()).optional(),
43
43
  createdAt: core.serialization.property("created_at", core.serialization.string()),
44
+ endAt: core.serialization.property("end_at", core.serialization.string().optional()),
44
45
  episodeIds: core.serialization.property("episode_ids", core.serialization.list(core.serialization.string()).optional()),
45
46
  labels: core.serialization.list(core.serialization.string()).optional(),
47
+ latestEvidenceAt: core.serialization.property("latest_evidence_at", core.serialization.string().optional()),
46
48
  name: core.serialization.string(),
47
49
  relevance: core.serialization.number().optional(),
48
50
  score: core.serialization.number().optional(),
49
51
  selectionRank: core.serialization.property("selection_rank", core.serialization.number().optional()),
52
+ startAt: core.serialization.property("start_at", core.serialization.string().optional()),
50
53
  summary: core.serialization.string().optional(),
51
54
  uuid: core.serialization.string(),
52
55
  });
@@ -0,0 +1,12 @@
1
+ /**
2
+ * This file was auto-generated by Fern from our API Definition.
3
+ */
4
+ import * as serializers from "../index.js";
5
+ import * as Zep from "../../api/index.js";
6
+ import * as core from "../../core/index.js";
7
+ export declare const GraphSearchResponseMetadata: core.serialization.ObjectSchema<serializers.GraphSearchResponseMetadata.Raw, Zep.GraphSearchResponseMetadata>;
8
+ export declare namespace GraphSearchResponseMetadata {
9
+ interface Raw {
10
+ server_latency_ms?: number | null;
11
+ }
12
+ }