@hydradb/sdk 2.1.5 → 2.1.6

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 (170) hide show
  1. package/dist/Client.d.ts +1 -1
  2. package/dist/Client.js +1 -1
  3. package/dist/api/client/requests/SearchQueryRequest.d.ts +10 -2
  4. package/dist/api/resources/connectors/client/requests/HandlerConfigureReq.d.ts +7 -0
  5. package/dist/api/resources/context/client/Client.d.ts +2 -2
  6. package/dist/api/resources/context/client/Client.js +10 -4
  7. package/dist/api/resources/context/client/requests/ChunksContextRequest.d.ts +1 -1
  8. package/dist/api/resources/context/client/requests/IngestContextRequest.d.ts +4 -2
  9. package/dist/api/resources/context/client/requests/ListV2ListContentRequest.d.ts +2 -3
  10. package/dist/api/resources/context/client/requests/RelationsContextRequest.d.ts +1 -1
  11. package/dist/api/resources/context/client/requests/SourcesV2SourceDeleteRequest.d.ts +2 -2
  12. package/dist/api/resources/context/client/requests/SubgraphContextRequest.d.ts +1 -1
  13. package/dist/api/resources/context/types/ChunksContextRequestType.d.ts +0 -1
  14. package/dist/api/resources/context/types/ChunksContextRequestType.js +0 -1
  15. package/dist/api/resources/context/types/IngestContextRequestType.d.ts +0 -1
  16. package/dist/api/resources/context/types/IngestContextRequestType.js +0 -1
  17. package/dist/api/resources/context/types/ListV2ListContentRequestType.d.ts +2 -4
  18. package/dist/api/resources/context/types/ListV2ListContentRequestType.js +2 -4
  19. package/dist/api/resources/context/types/RelationsContextRequestType.d.ts +0 -1
  20. package/dist/api/resources/context/types/RelationsContextRequestType.js +0 -1
  21. package/dist/api/resources/context/types/SourcesV2SourceDeleteRequestType.d.ts +2 -3
  22. package/dist/api/resources/context/types/SourcesV2SourceDeleteRequestType.js +2 -3
  23. package/dist/api/resources/context/types/SubgraphContextRequestType.d.ts +0 -1
  24. package/dist/api/resources/context/types/SubgraphContextRequestType.js +0 -1
  25. package/dist/api/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.d.ts +5 -7
  26. package/dist/api/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.js +5 -7
  27. package/dist/api/types/GraphRelationEvidence.d.ts +7 -0
  28. package/dist/api/types/HandlerConnectorLimitView.d.ts +15 -0
  29. package/dist/api/types/HandlerConnectorLimitView.js +3 -0
  30. package/dist/api/types/HandlerConnectorListResponse.d.ts +1 -0
  31. package/dist/api/types/HandlerEnvelopeSearchV2RetrievalResult.d.ts +2 -1
  32. package/dist/api/types/HandlerEnvelopeSearchV2RetrievalResultData.d.ts +5 -0
  33. package/dist/api/types/HandlerEnvelopeSearchV2RetrievalResultData.js +3 -0
  34. package/dist/api/types/IngestionGraphEntity.d.ts +8 -0
  35. package/dist/api/types/IngestionGraphEntity.js +3 -0
  36. package/dist/api/types/IngestionGraphPayload.d.ts +5 -0
  37. package/dist/api/types/IngestionGraphPayload.js +3 -0
  38. package/dist/api/types/IngestionGraphRelation.d.ts +9 -0
  39. package/dist/api/types/IngestionGraphRelation.js +3 -0
  40. package/dist/api/types/ListV2MemoryItem.d.ts +8 -0
  41. package/dist/api/types/ListV2SourceItem.d.ts +8 -0
  42. package/dist/api/types/MemoriesConversationTurn.d.ts +0 -2
  43. package/dist/api/types/MemoriesForcefulRelations.d.ts +11 -0
  44. package/dist/api/types/MemoriesForcefulRelations.js +3 -0
  45. package/dist/api/types/MemoriesIngestItem.d.ts +16 -16
  46. package/dist/api/types/MemoriesUnifiedIngestRequest.d.ts +16 -4
  47. package/dist/api/types/SearchCodeSearchRepoResult.d.ts +11 -0
  48. package/dist/api/types/SearchCodeSearchRepoResult.js +3 -0
  49. package/dist/api/types/SearchCodeSearchResult.d.ts +24 -0
  50. package/dist/api/types/SearchCodeSearchResult.js +3 -0
  51. package/dist/api/types/SearchGraphPlane.d.ts +3 -3
  52. package/dist/api/types/SearchQueryChunk.d.ts +19 -0
  53. package/dist/api/types/SearchQueryChunk.js +3 -0
  54. package/dist/api/types/SearchQueryChunkEnrichmentKind.d.ts +7 -0
  55. package/dist/api/types/SearchQueryChunkEnrichmentKind.js +10 -0
  56. package/dist/api/types/SearchQueryChunkTemporal.d.ts +8 -0
  57. package/dist/api/types/SearchQueryChunkTemporal.js +3 -0
  58. package/dist/api/types/SearchQueryForcefulRelation.d.ts +6 -0
  59. package/dist/api/types/SearchQueryForcefulRelation.js +3 -0
  60. package/dist/api/types/SearchQueryGraphEdge.d.ts +13 -0
  61. package/dist/api/types/SearchQueryGraphEdge.js +3 -0
  62. package/dist/api/types/SearchQueryGraphEntity.d.ts +4 -0
  63. package/dist/api/types/SearchQueryGraphEntity.js +3 -0
  64. package/dist/api/types/SearchQueryGraphPath.d.ts +9 -0
  65. package/dist/api/types/SearchQueryGraphPath.js +3 -0
  66. package/dist/api/types/SearchQueryGraphPathOrigin.d.ts +6 -0
  67. package/dist/api/types/SearchQueryGraphPathOrigin.js +9 -0
  68. package/dist/api/types/SearchQueryGraphTriplet.d.ts +6 -0
  69. package/dist/api/types/SearchQueryGraphTriplet.js +3 -0
  70. package/dist/api/types/SearchQueryResult.d.ts +14 -0
  71. package/dist/api/types/SearchQueryResult.js +3 -0
  72. package/dist/api/types/SearchResolvedReference.d.ts +4 -0
  73. package/dist/api/types/SearchResolvedReference.js +3 -0
  74. package/dist/api/types/SearchSourceType.d.ts +0 -1
  75. package/dist/api/types/SearchSourceType.js +0 -1
  76. package/dist/api/types/SearchV2RetrievalResult.d.ts +20 -0
  77. package/dist/api/types/TenantsDatabaseDetail.d.ts +2 -2
  78. package/dist/api/types/TenantsDatabaseDetailType.d.ts +2 -3
  79. package/dist/api/types/TenantsDatabaseDetailType.js +2 -3
  80. package/dist/api/types/TenantsInfraStatusResponseV2.d.ts +2 -2
  81. package/dist/api/types/TenantsInfraStatusResponseV2Type.d.ts +2 -3
  82. package/dist/api/types/TenantsInfraStatusResponseV2Type.js +2 -3
  83. package/dist/api/types/TenantsTenantIdsResponse.d.ts +1 -5
  84. package/dist/api/types/index.d.ts +19 -0
  85. package/dist/api/types/index.js +19 -0
  86. package/dist/helpers/buildString.d.ts +9 -3
  87. package/dist/helpers/buildString.js +28 -3
  88. package/dist/serialization/client/requests/SearchQueryRequest.d.ts +2 -0
  89. package/dist/serialization/client/requests/SearchQueryRequest.js +2 -0
  90. package/dist/serialization/resources/connectors/client/requests/HandlerConfigureReq.d.ts +1 -0
  91. package/dist/serialization/resources/connectors/client/requests/HandlerConfigureReq.js +1 -0
  92. package/dist/serialization/resources/context/types/ChunksContextRequestType.d.ts +1 -1
  93. package/dist/serialization/resources/context/types/ChunksContextRequestType.js +1 -1
  94. package/dist/serialization/resources/context/types/IngestContextRequestType.d.ts +1 -1
  95. package/dist/serialization/resources/context/types/IngestContextRequestType.js +1 -1
  96. package/dist/serialization/resources/context/types/ListV2ListContentRequestType.d.ts +1 -1
  97. package/dist/serialization/resources/context/types/ListV2ListContentRequestType.js +1 -1
  98. package/dist/serialization/resources/context/types/RelationsContextRequestType.d.ts +1 -1
  99. package/dist/serialization/resources/context/types/RelationsContextRequestType.js +1 -1
  100. package/dist/serialization/resources/context/types/SourcesV2SourceDeleteRequestType.d.ts +1 -1
  101. package/dist/serialization/resources/context/types/SourcesV2SourceDeleteRequestType.js +1 -1
  102. package/dist/serialization/resources/context/types/SubgraphContextRequestType.d.ts +1 -1
  103. package/dist/serialization/resources/context/types/SubgraphContextRequestType.js +1 -1
  104. package/dist/serialization/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.d.ts +1 -1
  105. package/dist/serialization/types/GithubComHydradbHydradbApplicationInternalPlatformStoragelayoutLayout.js +1 -1
  106. package/dist/serialization/types/GraphRelationEvidence.d.ts +1 -0
  107. package/dist/serialization/types/GraphRelationEvidence.js +1 -0
  108. package/dist/serialization/types/HandlerConnectorLimitView.d.ts +12 -0
  109. package/dist/serialization/types/HandlerConnectorLimitView.js +44 -0
  110. package/dist/serialization/types/HandlerConnectorListResponse.d.ts +2 -0
  111. package/dist/serialization/types/HandlerConnectorListResponse.js +2 -0
  112. package/dist/serialization/types/HandlerEnvelopeSearchV2RetrievalResult.d.ts +2 -2
  113. package/dist/serialization/types/HandlerEnvelopeSearchV2RetrievalResult.js +2 -2
  114. package/dist/serialization/types/HandlerEnvelopeSearchV2RetrievalResultData.d.ts +9 -0
  115. package/dist/serialization/types/HandlerEnvelopeSearchV2RetrievalResultData.js +41 -0
  116. package/dist/serialization/types/IngestionGraphEntity.d.ts +12 -0
  117. package/dist/serialization/types/IngestionGraphEntity.js +44 -0
  118. package/dist/serialization/types/IngestionGraphPayload.d.ts +12 -0
  119. package/dist/serialization/types/IngestionGraphPayload.js +44 -0
  120. package/dist/serialization/types/IngestionGraphRelation.d.ts +13 -0
  121. package/dist/serialization/types/IngestionGraphRelation.js +45 -0
  122. package/dist/serialization/types/ListV2MemoryItem.d.ts +1 -0
  123. package/dist/serialization/types/ListV2MemoryItem.js +1 -0
  124. package/dist/serialization/types/ListV2SourceItem.d.ts +1 -0
  125. package/dist/serialization/types/ListV2SourceItem.js +1 -0
  126. package/dist/serialization/types/MemoriesConversationTurn.d.ts +0 -1
  127. package/dist/serialization/types/MemoriesConversationTurn.js +0 -1
  128. package/dist/serialization/types/MemoriesForcefulRelations.d.ts +10 -0
  129. package/dist/serialization/types/MemoriesForcefulRelations.js +42 -0
  130. package/dist/serialization/types/MemoriesIngestItem.d.ts +4 -4
  131. package/dist/serialization/types/MemoriesIngestItem.js +4 -4
  132. package/dist/serialization/types/MemoriesUnifiedIngestRequest.d.ts +7 -2
  133. package/dist/serialization/types/MemoriesUnifiedIngestRequest.js +7 -2
  134. package/dist/serialization/types/SearchCodeSearchRepoResult.d.ts +15 -0
  135. package/dist/serialization/types/SearchCodeSearchRepoResult.js +47 -0
  136. package/dist/serialization/types/SearchCodeSearchResult.d.ts +14 -0
  137. package/dist/serialization/types/SearchCodeSearchResult.js +46 -0
  138. package/dist/serialization/types/SearchQueryChunk.d.ts +18 -0
  139. package/dist/serialization/types/SearchQueryChunk.js +50 -0
  140. package/dist/serialization/types/SearchQueryChunkEnrichmentKind.d.ts +7 -0
  141. package/dist/serialization/types/SearchQueryChunkEnrichmentKind.js +39 -0
  142. package/dist/serialization/types/SearchQueryChunkTemporal.d.ts +11 -0
  143. package/dist/serialization/types/SearchQueryChunkTemporal.js +43 -0
  144. package/dist/serialization/types/SearchQueryForcefulRelation.d.ts +12 -0
  145. package/dist/serialization/types/SearchQueryForcefulRelation.js +44 -0
  146. package/dist/serialization/types/SearchQueryGraphEdge.d.ts +14 -0
  147. package/dist/serialization/types/SearchQueryGraphEdge.js +46 -0
  148. package/dist/serialization/types/SearchQueryGraphEntity.d.ts +10 -0
  149. package/dist/serialization/types/SearchQueryGraphEntity.js +42 -0
  150. package/dist/serialization/types/SearchQueryGraphPath.d.ts +13 -0
  151. package/dist/serialization/types/SearchQueryGraphPath.js +45 -0
  152. package/dist/serialization/types/SearchQueryGraphPathOrigin.d.ts +7 -0
  153. package/dist/serialization/types/SearchQueryGraphPathOrigin.js +39 -0
  154. package/dist/serialization/types/SearchQueryGraphTriplet.d.ts +13 -0
  155. package/dist/serialization/types/SearchQueryGraphTriplet.js +45 -0
  156. package/dist/serialization/types/SearchQueryResult.d.ts +15 -0
  157. package/dist/serialization/types/SearchQueryResult.js +47 -0
  158. package/dist/serialization/types/SearchResolvedReference.d.ts +10 -0
  159. package/dist/serialization/types/SearchResolvedReference.js +42 -0
  160. package/dist/serialization/types/SearchSourceType.d.ts +1 -1
  161. package/dist/serialization/types/SearchSourceType.js +1 -1
  162. package/dist/serialization/types/SearchV2RetrievalResult.d.ts +6 -0
  163. package/dist/serialization/types/SearchV2RetrievalResult.js +6 -0
  164. package/dist/serialization/types/TenantsDatabaseDetailType.d.ts +1 -1
  165. package/dist/serialization/types/TenantsDatabaseDetailType.js +1 -1
  166. package/dist/serialization/types/TenantsInfraStatusResponseV2Type.d.ts +1 -1
  167. package/dist/serialization/types/TenantsInfraStatusResponseV2Type.js +1 -1
  168. package/dist/serialization/types/index.d.ts +19 -0
  169. package/dist/serialization/types/index.js +19 -0
  170. package/package.json +1 -1
@@ -11,8 +11,6 @@ export interface MemoriesIngestItem {
11
11
  */
12
12
  acl?: string[];
13
13
  attributes?: Record<string, unknown>;
14
- /** Extracted text content of the source document. */
15
- content?: string;
16
14
  /**
17
15
  * ContextCategory files this context under one of the three buckets
18
16
  * (PRO-1618). Omitted or "auto" leaves it to HydraDB; naming a bucket pins
@@ -22,23 +20,19 @@ export interface MemoriesIngestItem {
22
20
  contextCategory?: HydraDB.MemoriesIngestItemContextCategory;
23
21
  contextId?: string;
24
22
  /**
25
- * Conversation is the canonical name; `messages` is accepted as an alias.
26
- * Both are the shape a developer already builds for OpenAI or Anthropic.
23
+ * Conversation is the shape a developer already builds for OpenAI or
24
+ * Anthropic: `[{role, content}]`.
27
25
  */
28
26
  conversation?: HydraDB.MemoriesConversationTurn[];
29
27
  customAttributes?: Record<string, unknown>;
30
- customInstructions?: string;
31
28
  enrich?: boolean;
29
+ forcefulRelations?: HydraDB.MemoriesForcefulRelations;
32
30
  happenedAt?: string;
33
31
  /**
34
- * IsMarkdown tells the pipeline the text is markdown, so it is chunked on
35
- * structure rather than as flat prose. The split memories[] path has always
36
- * carried it; a unified database has no other ingest shape, so without it
37
- * here a markdown sync has nowhere to say so.
32
+ * Instructions steer enrichment for this item. The request-level value is
33
+ * the default when an item names none.
38
34
  */
39
- isMarkdown?: boolean;
40
- messages?: HydraDB.MemoriesConversationTurn[];
41
- /** Text is the canonical name; `content` is accepted as an alias. */
35
+ instructions?: string;
42
36
  text?: string;
43
37
  /**
44
38
  * Title names the context. It becomes the context's document title, and it
@@ -47,10 +41,16 @@ export interface MemoriesIngestItem {
47
41
  */
48
42
  title?: string;
49
43
  /**
50
- * UserName is the speaker identity for a TEXT item. A conversation names
51
- * its speaker per turn instead, and that stays authoritative: this field
52
- * only fills in when the turns supplied none. Empty ends up as "User",
53
- * matching the split path, so the pipeline is never handed a blank.
44
+ * Upsert decides, for THIS item, whether an existing context with the same
45
+ * context_id is replaced. The request-level value is the default. This is
46
+ * what lets one call replace some contexts and append others.
47
+ */
48
+ upsert?: boolean;
49
+ /**
50
+ * UserName is the speaker identity for the item, on both shapes: a text
51
+ * item is what that person said, a conversation's user turns are theirs.
52
+ * Empty ends up as "User", matching the split path, so the pipeline is
53
+ * never handed a blank.
54
54
  */
55
55
  userName?: string;
56
56
  }
@@ -2,13 +2,25 @@ import type * as HydraDB from "../index.js";
2
2
  export interface MemoriesUnifiedIngestRequest {
3
3
  /** Collection scope. Defaults to the default collection when omitted. Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still accepted (deprecated). */
4
4
  collection?: string;
5
- contexts?: HydraDB.MemoriesIngestItem[];
5
+ /** Context is the list of contexts to ingest. */
6
+ context?: HydraDB.MemoriesIngestItem[];
6
7
  /** Owning database. Formerly `tenant_id`; the `tenant_id` alias is still accepted (deprecated). */
7
8
  database?: string;
9
+ enrich?: boolean;
8
10
  /**
9
- * Items is the canonical name from the design spec. `contexts` is accepted
10
- * as an alias because the field was drafted under that name.
11
+ * GraphPayload is the bring-your-own-graph map, keyed by context_id. Every
12
+ * key must name an item in this request, so a typo cannot silently drop a
13
+ * graph.
14
+ */
15
+ graphPayload?: Record<string, HydraDB.IngestionGraphPayload>;
16
+ instructions?: string;
17
+ /** deprecated: use collection */
18
+ subTenantId?: string;
19
+ /** deprecated: use database */
20
+ tenantId?: string;
21
+ /**
22
+ * Upsert, Enrich and Instructions are the request-level defaults for the
23
+ * item-level fields of the same name: true, true and "" when absent.
11
24
  */
12
- items?: HydraDB.MemoriesIngestItem[];
13
25
  upsert?: boolean;
14
26
  }
@@ -0,0 +1,11 @@
1
+ export interface SearchCodeSearchRepoResult {
2
+ answer?: string;
3
+ durationMs?: number;
4
+ /** Error message, empty string on success. */
5
+ error?: string;
6
+ repo?: string;
7
+ /** Current lifecycle or processing state. */
8
+ status?: string;
9
+ truncated?: boolean;
10
+ unsigned?: boolean;
11
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,24 @@
1
+ import type * as HydraDB from "../index.js";
2
+ /**
3
+ * CodeSearch is the repository code-search branch's answer, when routed.
4
+ */
5
+ export interface SearchCodeSearchResult {
6
+ /**
7
+ * DecidedBy names the signal that routed the query: "request" (caller
8
+ * forced it), "planner" (is_code_query) or "stage2" (embedding router).
9
+ */
10
+ decidedBy?: string;
11
+ /** DurationMS is the wall time the branch took. */
12
+ durationMs?: number;
13
+ /** Reason explains a non-ok status in one sentence. */
14
+ reason?: string;
15
+ /** Repos lists each repository searched with its own status and answer. */
16
+ repos?: HydraDB.SearchCodeSearchRepoResult[];
17
+ /**
18
+ * Status is "ok" when at least one repository answered, "not_found" when
19
+ * none had an archive, "error"/"timeout" when the branch failed, or
20
+ * "skipped" with a Reason when it was not attempted (no repositories
21
+ * connected, caller opted out).
22
+ */
23
+ status?: string;
24
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -1,10 +1,10 @@
1
1
  import type * as HydraDB from "../index.js";
2
2
  /**
3
- * Graph is the unified graph plane (PRO-1618): query_paths and
3
+ * Graph is the consolidated graph plane: query_paths and
4
4
  * chunk_relations consolidated into one ordered paths[] list, with each
5
5
  * path carrying the chunk ids it supports so the caller no longer joins
6
- * against chunk_id_to_group_ids. Populated whenever graph_context is on,
7
- * on BOTH layouts; graph_context stays populated beside it.
6
+ * against chunk_id_to_group_ids. Populated whenever graph_context is on;
7
+ * graph_context stays populated beside it.
8
8
  */
9
9
  export interface SearchGraphPlane {
10
10
  paths?: HydraDB.SearchGraphPath[];
@@ -0,0 +1,19 @@
1
+ import type * as HydraDB from "../index.js";
2
+ export interface SearchQueryChunk {
3
+ /** The chunk's id. Every graph hop names the chunk it was extracted from by this id. */
4
+ chunkId: string;
5
+ /** The chunk's own text. Enrichment is not concatenated into it. */
6
+ content: string;
7
+ /** The id of the context (source) the chunk belongs to. */
8
+ contextId: string;
9
+ /** What enrichment produced for the chunk, kept apart from content. Absent when nothing was produced. */
10
+ enrichment?: string;
11
+ /** The context_category the author declared at ingest (user_preference, business_knowledge or decision_trace). Never inferred. Absent when none was declared. */
12
+ enrichmentKind?: HydraDB.SearchQueryChunkEnrichmentKind;
13
+ /** When the context this chunk belongs to was received (RFC 3339). This is the ingest time, not the caller's happened_at, which is not echoed here. Omitted when the store holds no receipt time for the row (older rows); it is never sent empty. */
14
+ receivedAt?: string;
15
+ /** Relevance after reranking. */
16
+ score: number;
17
+ /** Dated facts extracted from the chunk. Present only when the query engaged temporal reasoning. */
18
+ temporal?: HydraDB.SearchQueryChunkTemporal[];
19
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,7 @@
1
+ /** The context_category the author declared at ingest (user_preference, business_knowledge or decision_trace). Never inferred. Absent when none was declared. */
2
+ export declare const SearchQueryChunkEnrichmentKind: {
3
+ readonly UserPreference: "user_preference";
4
+ readonly BusinessKnowledge: "business_knowledge";
5
+ readonly DecisionTrace: "decision_trace";
6
+ };
7
+ export type SearchQueryChunkEnrichmentKind = (typeof SearchQueryChunkEnrichmentKind)[keyof typeof SearchQueryChunkEnrichmentKind];
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.SearchQueryChunkEnrichmentKind = void 0;
5
+ /** The context_category the author declared at ingest (user_preference, business_knowledge or decision_trace). Never inferred. Absent when none was declared. */
6
+ exports.SearchQueryChunkEnrichmentKind = {
7
+ UserPreference: "user_preference",
8
+ BusinessKnowledge: "business_knowledge",
9
+ DecisionTrace: "decision_trace",
10
+ };
@@ -0,0 +1,8 @@
1
+ export interface SearchQueryChunkTemporal {
2
+ /** The fact as a sentence with its dates embedded. */
3
+ content: string;
4
+ /** End of the fact's window, YYYY-MM-DD, or null. */
5
+ endDate: string | null;
6
+ /** Start of the fact's window, YYYY-MM-DD, or null. */
7
+ startDate: string | null;
8
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,6 @@
1
+ import type * as HydraDB from "../index.js";
2
+ export interface SearchQueryForcefulRelation {
3
+ chunk: HydraDB.SearchQueryChunk;
4
+ /** The declared edge that pulled the chunk in: from is the context that declared it, to is the chunk's own context. */
5
+ via: HydraDB.SearchRelationVia;
6
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,13 @@
1
+ export interface SearchQueryGraphEdge {
2
+ /** The chunk the relation was extracted from. For a chunk_relation path this is the returned chunk the path hangs under. */
3
+ chunkId: string;
4
+ /** The sentence the relation was extracted from. */
5
+ context: string;
6
+ /** The relation between the two entities. */
7
+ predicate: string;
8
+ /** The relation's stable id. */
9
+ relationshipId: string;
10
+ /** When the relation held, as extraction phrased it. */
11
+ temporalDetails?: string;
12
+ timestamp?: number | null;
13
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,4 @@
1
+ export interface SearchQueryGraphEntity {
2
+ entityId: string;
3
+ name: string;
4
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,9 @@
1
+ import type * as HydraDB from "../index.js";
2
+ export interface SearchQueryGraphPath {
3
+ /** Which lane found the path: query_path (grown from the entities in the query) or chunk_relation (the neighbourhood of a returned chunk). */
4
+ origin: HydraDB.SearchQueryGraphPathOrigin;
5
+ /** The path narrated as one sentence. */
6
+ pathSummary: string;
7
+ /** The path's hops, in order. */
8
+ triplets: HydraDB.SearchQueryGraphTriplet[];
9
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,6 @@
1
+ /** Which lane found the path: query_path (grown from the entities in the query) or chunk_relation (the neighbourhood of a returned chunk). */
2
+ export declare const SearchQueryGraphPathOrigin: {
3
+ readonly QueryPath: "query_path";
4
+ readonly ChunkRelation: "chunk_relation";
5
+ };
6
+ export type SearchQueryGraphPathOrigin = (typeof SearchQueryGraphPathOrigin)[keyof typeof SearchQueryGraphPathOrigin];
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.SearchQueryGraphPathOrigin = void 0;
5
+ /** Which lane found the path: query_path (grown from the entities in the query) or chunk_relation (the neighbourhood of a returned chunk). */
6
+ exports.SearchQueryGraphPathOrigin = {
7
+ QueryPath: "query_path",
8
+ ChunkRelation: "chunk_relation",
9
+ };
@@ -0,0 +1,6 @@
1
+ import type * as HydraDB from "../index.js";
2
+ export interface SearchQueryGraphTriplet {
3
+ relation: HydraDB.SearchQueryGraphEdge;
4
+ source: HydraDB.SearchQueryGraphEntity;
5
+ target: HydraDB.SearchQueryGraphEntity;
6
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,14 @@
1
+ import type * as HydraDB from "../index.js";
2
+ /**
3
+ * The four-key /query response body: chunks, graph, forceful_relations and llm_prompt, and nothing else.
4
+ */
5
+ export interface SearchQueryResult {
6
+ /** Retrieved chunks, ranked. Each carries its own text, enrichment and received_at, and nothing else about its source: POST /context/list with its context_id in `ids` returns the source's title, type, collection and metadata. */
7
+ chunks: HydraDB.SearchQueryChunk[];
8
+ /** Chunks pulled in because the author declared forceful_relations at ingest. [] when none were declared or follow_forceful_relations was false. */
9
+ forcefulRelations: HydraDB.SearchQueryForcefulRelation[];
10
+ /** Graph paths, query paths first then chunk relations, deduplicated. [] when graph_context was false. */
11
+ graph: HydraDB.SearchQueryGraphPath[];
12
+ /** The whole response rendered as markdown for a model call: numbered results with their relevance, forceful relations, related facts labelled P1..Pn in `graph` order and citing the results they came from, temporal facts and sources. It also carries what this body has no key for: a computed duration, source facts, entity profiles, the code-search answer, the aliases and references the query was expanded with, decision-trace evidence, and a note when a lookup failed or was truncated. Inject it verbatim. */
13
+ llmPrompt: string;
14
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,4 @@
1
+ export interface SearchResolvedReference {
2
+ expression?: string;
3
+ resolvedTo?: string;
4
+ }
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ // This file was auto-generated by Fern from our API Definition.
3
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -7,6 +7,5 @@ export declare const SearchSourceType: {
7
7
  readonly Knowledge: "knowledge";
8
8
  readonly Memory: "memory";
9
9
  readonly All: "all";
10
- readonly Unified: "unified";
11
10
  };
12
11
  export type SearchSourceType = (typeof SearchSourceType)[keyof typeof SearchSourceType];
@@ -11,5 +11,4 @@ exports.SearchSourceType = {
11
11
  Knowledge: "knowledge",
12
12
  Memory: "memory",
13
13
  All: "all",
14
- Unified: "unified",
15
14
  };
@@ -11,11 +11,31 @@ export interface SearchV2RetrievalResult {
11
11
  appSearchFusion?: HydraDB.SearchAppSearchFusionDiagnostics;
12
12
  /** Retrieved and ranked chunks from the knowledge store or memories. */
13
13
  chunks?: HydraDB.SearchV2Chunk[];
14
+ codeSearch?: HydraDB.SearchCodeSearchResult;
14
15
  forcefulRelations?: HydraDB.SearchForcefulRelationsBucket;
15
16
  graph?: HydraDB.SearchGraphPlane;
16
17
  graphContext?: HydraDB.SearchGraphContext;
18
+ /**
19
+ * LLMPrompt is the whole response rendered as Markdown for a model call
20
+ * (PRO-2067): numbered results with their content and citable ids, related
21
+ * facts with evidence, temporal facts, profiles and sources. It is never
22
+ * empty on /query — a zero-match query renders an explicit no-results
23
+ * message naming any filter that constrained the search. Inject it
24
+ * verbatim.
25
+ */
26
+ llmPrompt?: string;
17
27
  profileContext?: HydraDB.SearchProfileContext;
18
28
  profileFilter?: HydraDB.SearchProfileFilterInfo;
29
+ /**
30
+ * Profiles are the auto-selected profiles for the query's graph-resolved
31
+ * entities (PRO-1797); additive to ProfileContext, omitted when none.
32
+ */
33
+ profiles?: HydraDB.SearchProfileContext[];
34
+ /**
35
+ * ResolvedReferences report description-based references the query resolved
36
+ * and expanded with (PRO-1797 Stage 2); omitted when none.
37
+ */
38
+ resolvedReferences?: HydraDB.SearchResolvedReference[];
19
39
  /**
20
40
  * SourceFacts surface the matched app-native (edge_source) facts when
21
41
  * source_reasoning was active; omitted otherwise (PRO-1602).
@@ -4,8 +4,8 @@ export interface TenantsDatabaseDetail {
4
4
  database?: string;
5
5
  /**
6
6
  * Type is the storage layout the database was created with: "split" (a
7
- * knowledge and a memory corpus, selected by `type` on every call) or
8
- * "unified" (one corpus; `type` defaults to unified).
7
+ * knowledge and a memory corpus, selected by `type` on every call).
8
+ * Absent where the deployment does not expose the layout.
9
9
  */
10
10
  type?: HydraDB.TenantsDatabaseDetailType;
11
11
  }
@@ -1,10 +1,9 @@
1
1
  /**
2
2
  * Type is the storage layout the database was created with: "split" (a
3
- * knowledge and a memory corpus, selected by `type` on every call) or
4
- * "unified" (one corpus; `type` defaults to unified).
3
+ * knowledge and a memory corpus, selected by `type` on every call).
4
+ * Absent where the deployment does not expose the layout.
5
5
  */
6
6
  export declare const TenantsDatabaseDetailType: {
7
7
  readonly Split: "split";
8
- readonly Unified: "unified";
9
8
  };
10
9
  export type TenantsDatabaseDetailType = (typeof TenantsDatabaseDetailType)[keyof typeof TenantsDatabaseDetailType];
@@ -4,10 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
4
4
  exports.TenantsDatabaseDetailType = void 0;
5
5
  /**
6
6
  * Type is the storage layout the database was created with: "split" (a
7
- * knowledge and a memory corpus, selected by `type` on every call) or
8
- * "unified" (one corpus; `type` defaults to unified).
7
+ * knowledge and a memory corpus, selected by `type` on every call).
8
+ * Absent where the deployment does not expose the layout.
9
9
  */
10
10
  exports.TenantsDatabaseDetailType = {
11
11
  Split: "split",
12
- Unified: "unified",
13
12
  };
@@ -9,8 +9,8 @@ export interface TenantsInfraStatusResponseV2 {
9
9
  orgId?: string;
10
10
  tenantId?: string;
11
11
  /**
12
- * Type is the storage layout (split or unified) the database was created
13
- * with; absent while the database is deleting or unknown.
12
+ * Type is the storage layout the database was created with; absent while the
13
+ * database is deleting or unknown.
14
14
  */
15
15
  type?: HydraDB.TenantsInfraStatusResponseV2Type;
16
16
  }
@@ -1,9 +1,8 @@
1
1
  /**
2
- * Type is the storage layout (split or unified) the database was created
3
- * with; absent while the database is deleting or unknown.
2
+ * Type is the storage layout the database was created with; absent while the
3
+ * database is deleting or unknown.
4
4
  */
5
5
  export declare const TenantsInfraStatusResponseV2Type: {
6
6
  readonly Split: "split";
7
- readonly Unified: "unified";
8
7
  };
9
8
  export type TenantsInfraStatusResponseV2Type = (typeof TenantsInfraStatusResponseV2Type)[keyof typeof TenantsInfraStatusResponseV2Type];
@@ -3,10 +3,9 @@
3
3
  Object.defineProperty(exports, "__esModule", { value: true });
4
4
  exports.TenantsInfraStatusResponseV2Type = void 0;
5
5
  /**
6
- * Type is the storage layout (split or unified) the database was created
7
- * with; absent while the database is deleting or unknown.
6
+ * Type is the storage layout the database was created with; absent while the
7
+ * database is deleting or unknown.
8
8
  */
9
9
  exports.TenantsInfraStatusResponseV2Type = {
10
10
  Split: "split",
11
- Unified: "unified",
12
11
  };
@@ -2,11 +2,7 @@ import type * as HydraDB from "../index.js";
2
2
  export interface TenantsTenantIdsResponse {
3
3
  /** List of database identifiers. */
4
4
  databases?: string[];
5
- /**
6
- * Details carries one entry per live database with its storage layout
7
- * (PRO-1618), so a client can tell a unified database (type-less
8
- * items[] ingest and query) from a split one without a failed request.
9
- */
5
+ /** Details carries one entry per live database with its storage layout. */
10
6
  details?: HydraDB.TenantsDatabaseDetail[];
11
7
  /** Databases that failed provisioning, with error details. */
12
8
  failedDatabases?: HydraDB.TenantsFailedTenant[];
@@ -21,6 +21,7 @@ export * from "./HandlerConnectorApiView.js";
21
21
  export * from "./HandlerConnectorCatalogResponse.js";
22
22
  export * from "./HandlerConnectorCreateResponse.js";
23
23
  export * from "./HandlerConnectorDeleteResponse.js";
24
+ export * from "./HandlerConnectorLimitView.js";
24
25
  export * from "./HandlerConnectorListResponse.js";
25
26
  export * from "./HandlerConnectorPauseResponse.js";
26
27
  export * from "./HandlerConnectorResourceStatus.js";
@@ -45,6 +46,7 @@ export * from "./HandlerEnvelopeListV2ListResponse.js";
45
46
  export * from "./HandlerEnvelopeSearchChunkInspectResult.js";
46
47
  export * from "./HandlerEnvelopeSearchEntityProfileView.js";
47
48
  export * from "./HandlerEnvelopeSearchV2RetrievalResult.js";
49
+ export * from "./HandlerEnvelopeSearchV2RetrievalResultData.js";
48
50
  export * from "./HandlerEnvelopeSourcesMemoryDeleteResponse.js";
49
51
  export * from "./HandlerEnvelopeTenantsInfraStatusResponseV2.js";
50
52
  export * from "./HandlerEnvelopeTenantsSubTenantDeleteResponse.js";
@@ -81,6 +83,9 @@ export * from "./HandlerVaultCredentialEntry.js";
81
83
  export * from "./HandlerVaultCredentialListResponse.js";
82
84
  export * from "./HandlerVaultCredentialRevealResponse.js";
83
85
  export * from "./HandlerVaultCredentialUpdateResponse.js";
86
+ export * from "./IngestionGraphEntity.js";
87
+ export * from "./IngestionGraphPayload.js";
88
+ export * from "./IngestionGraphRelation.js";
84
89
  export * from "./IngestionSourceStatus.js";
85
90
  export * from "./IngestionV2BatchProcessingStatus.js";
86
91
  export * from "./IngestionV2IngestResponse.js";
@@ -91,6 +96,7 @@ export * from "./ListV2ListResponse.js";
91
96
  export * from "./ListV2MemoryItem.js";
92
97
  export * from "./ListV2SourceItem.js";
93
98
  export * from "./MemoriesConversationTurn.js";
99
+ export * from "./MemoriesForcefulRelations.js";
94
100
  export * from "./MemoriesIngestItem.js";
95
101
  export * from "./MemoriesIngestItemContextCategory.js";
96
102
  export * from "./MemoriesUnifiedIngestRequest.js";
@@ -98,6 +104,8 @@ export * from "./SearchAliasExpansionNote.js";
98
104
  export * from "./SearchAppSearchFusionDiagnostics.js";
99
105
  export * from "./SearchAppSearchFusionStats.js";
100
106
  export * from "./SearchChunkInspectResult.js";
107
+ export * from "./SearchCodeSearchRepoResult.js";
108
+ export * from "./SearchCodeSearchResult.js";
101
109
  export * from "./SearchEntityProfileView.js";
102
110
  export * from "./SearchForcefulRelationEntry.js";
103
111
  export * from "./SearchForcefulRelationsBucket.js";
@@ -111,10 +119,21 @@ export * from "./SearchProfileContext.js";
111
119
  export * from "./SearchProfileEntry.js";
112
120
  export * from "./SearchProfileFilterInfo.js";
113
121
  export * from "./SearchQueryBy.js";
122
+ export * from "./SearchQueryChunk.js";
123
+ export * from "./SearchQueryChunkEnrichmentKind.js";
124
+ export * from "./SearchQueryChunkTemporal.js";
125
+ export * from "./SearchQueryForcefulRelation.js";
126
+ export * from "./SearchQueryGraphEdge.js";
127
+ export * from "./SearchQueryGraphEntity.js";
128
+ export * from "./SearchQueryGraphPath.js";
129
+ export * from "./SearchQueryGraphPathOrigin.js";
130
+ export * from "./SearchQueryGraphTriplet.js";
114
131
  export * from "./SearchQueryRequestCollections.js";
115
132
  export * from "./SearchQueryRequestSubTenantIds.js";
133
+ export * from "./SearchQueryResult.js";
116
134
  export * from "./SearchRecallMode.js";
117
135
  export * from "./SearchRelationVia.js";
136
+ export * from "./SearchResolvedReference.js";
118
137
  export * from "./SearchScoredPathResponse.js";
119
138
  export * from "./SearchSourceFact.js";
120
139
  export * from "./SearchSourceFilterInfo.js";
@@ -37,6 +37,7 @@ __exportStar(require("./HandlerConnectorApiView.js"), exports);
37
37
  __exportStar(require("./HandlerConnectorCatalogResponse.js"), exports);
38
38
  __exportStar(require("./HandlerConnectorCreateResponse.js"), exports);
39
39
  __exportStar(require("./HandlerConnectorDeleteResponse.js"), exports);
40
+ __exportStar(require("./HandlerConnectorLimitView.js"), exports);
40
41
  __exportStar(require("./HandlerConnectorListResponse.js"), exports);
41
42
  __exportStar(require("./HandlerConnectorPauseResponse.js"), exports);
42
43
  __exportStar(require("./HandlerConnectorResourceStatus.js"), exports);
@@ -61,6 +62,7 @@ __exportStar(require("./HandlerEnvelopeListV2ListResponse.js"), exports);
61
62
  __exportStar(require("./HandlerEnvelopeSearchChunkInspectResult.js"), exports);
62
63
  __exportStar(require("./HandlerEnvelopeSearchEntityProfileView.js"), exports);
63
64
  __exportStar(require("./HandlerEnvelopeSearchV2RetrievalResult.js"), exports);
65
+ __exportStar(require("./HandlerEnvelopeSearchV2RetrievalResultData.js"), exports);
64
66
  __exportStar(require("./HandlerEnvelopeSourcesMemoryDeleteResponse.js"), exports);
65
67
  __exportStar(require("./HandlerEnvelopeTenantsInfraStatusResponseV2.js"), exports);
66
68
  __exportStar(require("./HandlerEnvelopeTenantsSubTenantDeleteResponse.js"), exports);
@@ -97,6 +99,9 @@ __exportStar(require("./HandlerVaultCredentialEntry.js"), exports);
97
99
  __exportStar(require("./HandlerVaultCredentialListResponse.js"), exports);
98
100
  __exportStar(require("./HandlerVaultCredentialRevealResponse.js"), exports);
99
101
  __exportStar(require("./HandlerVaultCredentialUpdateResponse.js"), exports);
102
+ __exportStar(require("./IngestionGraphEntity.js"), exports);
103
+ __exportStar(require("./IngestionGraphPayload.js"), exports);
104
+ __exportStar(require("./IngestionGraphRelation.js"), exports);
100
105
  __exportStar(require("./IngestionSourceStatus.js"), exports);
101
106
  __exportStar(require("./IngestionV2BatchProcessingStatus.js"), exports);
102
107
  __exportStar(require("./IngestionV2IngestResponse.js"), exports);
@@ -107,6 +112,7 @@ __exportStar(require("./ListV2ListResponse.js"), exports);
107
112
  __exportStar(require("./ListV2MemoryItem.js"), exports);
108
113
  __exportStar(require("./ListV2SourceItem.js"), exports);
109
114
  __exportStar(require("./MemoriesConversationTurn.js"), exports);
115
+ __exportStar(require("./MemoriesForcefulRelations.js"), exports);
110
116
  __exportStar(require("./MemoriesIngestItem.js"), exports);
111
117
  __exportStar(require("./MemoriesIngestItemContextCategory.js"), exports);
112
118
  __exportStar(require("./MemoriesUnifiedIngestRequest.js"), exports);
@@ -114,6 +120,8 @@ __exportStar(require("./SearchAliasExpansionNote.js"), exports);
114
120
  __exportStar(require("./SearchAppSearchFusionDiagnostics.js"), exports);
115
121
  __exportStar(require("./SearchAppSearchFusionStats.js"), exports);
116
122
  __exportStar(require("./SearchChunkInspectResult.js"), exports);
123
+ __exportStar(require("./SearchCodeSearchRepoResult.js"), exports);
124
+ __exportStar(require("./SearchCodeSearchResult.js"), exports);
117
125
  __exportStar(require("./SearchEntityProfileView.js"), exports);
118
126
  __exportStar(require("./SearchForcefulRelationEntry.js"), exports);
119
127
  __exportStar(require("./SearchForcefulRelationsBucket.js"), exports);
@@ -127,10 +135,21 @@ __exportStar(require("./SearchProfileContext.js"), exports);
127
135
  __exportStar(require("./SearchProfileEntry.js"), exports);
128
136
  __exportStar(require("./SearchProfileFilterInfo.js"), exports);
129
137
  __exportStar(require("./SearchQueryBy.js"), exports);
138
+ __exportStar(require("./SearchQueryChunk.js"), exports);
139
+ __exportStar(require("./SearchQueryChunkEnrichmentKind.js"), exports);
140
+ __exportStar(require("./SearchQueryChunkTemporal.js"), exports);
141
+ __exportStar(require("./SearchQueryForcefulRelation.js"), exports);
142
+ __exportStar(require("./SearchQueryGraphEdge.js"), exports);
143
+ __exportStar(require("./SearchQueryGraphEntity.js"), exports);
144
+ __exportStar(require("./SearchQueryGraphPath.js"), exports);
145
+ __exportStar(require("./SearchQueryGraphPathOrigin.js"), exports);
146
+ __exportStar(require("./SearchQueryGraphTriplet.js"), exports);
130
147
  __exportStar(require("./SearchQueryRequestCollections.js"), exports);
131
148
  __exportStar(require("./SearchQueryRequestSubTenantIds.js"), exports);
149
+ __exportStar(require("./SearchQueryResult.js"), exports);
132
150
  __exportStar(require("./SearchRecallMode.js"), exports);
133
151
  __exportStar(require("./SearchRelationVia.js"), exports);
152
+ __exportStar(require("./SearchResolvedReference.js"), exports);
134
153
  __exportStar(require("./SearchScoredPathResponse.js"), exports);
135
154
  __exportStar(require("./SearchSourceFact.js"), exports);
136
155
  __exportStar(require("./SearchSourceFilterInfo.js"), exports);