@memnexus-ai/sdk 1.76.8 → 1.77.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.
- package/dist/index.d.cts +23 -4
- package/dist/index.d.ts +23 -4
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -673,6 +673,13 @@ interface SearchRequest {
|
|
|
673
673
|
/** EXPERIMENTAL — dev-measurement only. Per-request override of the v2.74 Phase B assistant-claims serving flag (env ASSISTANT_CLAIMS_SERVING), used by the eval harness to run treatment (conditional serving) vs control (Phase A exclusion) arms in one pass. Honored ONLY when the server has ASSISTANT_CLAIMS_SERVING_PARAM_ENABLED=true (dev); otherwise silently ignored (no error). true enables Phase B conditional serving (the F20 trigger still decides per-query whether assistant-origin claims surface); false forces Phase A exclusion. Absent → server default. Not for production use. */
|
|
674
674
|
assistantClaimsServing?: boolean;
|
|
675
675
|
}
|
|
676
|
+
/** Present ONLY when at least one of this result's claims sits in a claim group whose conflict check did not complete (v2.91). Conflict detection scores ALIGNS_WITH claim pairs with an LLM judge on the search path; that scoring can be skipped because the judge was unavailable, the per-request pair cap was reached, the wall-clock budget expired, or a judge response failed to parse. When this field is present, the absence of a conflict marker in this result's summary_facts means NO CONFLICT WAS DEMONSTRATED — not that none exists. Cross-reference groupIds against claim_groups[].id for the group's conflict_status. ABSENT (not false, not an empty object) when every sampled pair covering this result was scored — a fully-scored response gains no new field. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that conflict scoring completed there. */
|
|
677
|
+
interface ConflictScoringIncomplete {
|
|
678
|
+
/** Ids of the claim groups covering this result whose conflict scoring did not complete. Each matches a claim_groups[].id in the same response, where conflict_status is 'partial' (some sampled pairs unscored) or 'unknown' (none scored). Never empty when this object is present. */
|
|
679
|
+
groupIds: string[];
|
|
680
|
+
/** Distinct ALIGNS_WITH claim pairs left unscored, summed across groupIds. Present only when > 0. Counted over the SAMPLED neighbor set (up to the top 20 edges per claim by embedding similarity), so it is a lower bound on unevaluated relationships, not a total. Absent when the group carries no count, which does not mean zero. */
|
|
681
|
+
unscoredPairs?: number;
|
|
682
|
+
}
|
|
676
683
|
interface Entity {
|
|
677
684
|
/** Entity name */
|
|
678
685
|
name?: string;
|
|
@@ -708,6 +715,8 @@ interface SearchResult {
|
|
|
708
715
|
effectiveState?: string;
|
|
709
716
|
/** Human-readable caveat present ONLY on results with effectiveState='superseded' (v2.76, #4611). Supersession is session-granular: a memory is marked superseded when ANY fact in it was later updated, so most of its facts are typically still accurate. This notice says the session was partially updated; individual outdated lines in summary_facts are marked [SUPERSEDED] with the newer value quoted inline. Additive and optional — absent on current results, and absent entirely unless SUPERSEDED_RETRIEVAL_MODE='demote'. */
|
|
710
717
|
supersessionNotice?: string;
|
|
718
|
+
/** Present ONLY when at least one of this result's claims sits in a claim group whose conflict check did not complete (v2.91). Conflict detection scores ALIGNS_WITH claim pairs with an LLM judge on the search path; that scoring can be skipped because the judge was unavailable, the per-request pair cap was reached, the wall-clock budget expired, or a judge response failed to parse. When this field is present, the absence of a conflict marker in this result's summary_facts means NO CONFLICT WAS DEMONSTRATED — not that none exists. Cross-reference groupIds against claim_groups[].id for the group's conflict_status. ABSENT (not false, not an empty object) when every sampled pair covering this result was scored — a fully-scored response gains no new field. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that conflict scoring completed there. */
|
|
719
|
+
conflictScoringIncomplete?: ConflictScoringIncomplete;
|
|
711
720
|
/** Confidence score (0-1) */
|
|
712
721
|
confidenceScore?: number;
|
|
713
722
|
/** Overall relevance score for this result */
|
|
@@ -792,6 +801,10 @@ interface SearchMeta {
|
|
|
792
801
|
degraded?: boolean;
|
|
793
802
|
/** The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted, and the field is absent entirely on the healthy path. */
|
|
794
803
|
branchFailures?: BranchFailure[];
|
|
804
|
+
/** True when the fulltext-anchor gate discarded a non-empty candidate set for this query, so this page does NOT include everything the search found. Combine with total: total=0 alongside this flag means the empty result is an artefact of the gate, not a statement that no matching memory exists, and a larger limit may return results. DISTINCT from degraded, which is false here because every search branch succeeded. ABSENT (not false) when the gate suppressed nothing — an unsuppressed response gains no new fields. This field is emitted by the search and digest responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
805
|
+
anchorGateSuppressed?: boolean;
|
|
806
|
+
/** How many fused candidates the fulltext-anchor gate discarded, summed across every hybrid search whose health this request captured; reformulation searches issued under `rewrite=true` are NOT included, so on such a request this count can under-report, and both fields can be absent entirely even though the gate did suppress. Present only alongside anchorGateSuppressed, and always > 0 when present. Treat it as an UPPER BOUND on what a larger limit could recover, not as a count of retrievable rows: the gate runs before the superseded/duplicate exclusion, so discarded candidates can include duplicate-state rows that are never served at any limit and superseded rows that are served only when the caller asks for them. This field is emitted by the search and digest responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
807
|
+
anchorGateDiscardedCount?: number;
|
|
795
808
|
/** Temporal query metadata (present when temporal filters are used) */
|
|
796
809
|
temporalMetadata?: TemporalMetadata;
|
|
797
810
|
}
|
|
@@ -826,13 +839,13 @@ interface ClaimGroupClaim {
|
|
|
826
839
|
interface ClaimGroupSignals {
|
|
827
840
|
/** Number of claims in this group */
|
|
828
841
|
n_claims: number;
|
|
829
|
-
/** Minimum LLM-judged alignment score among
|
|
842
|
+
/** Minimum LLM-judged alignment score among the SCORED pairs in the group (0=conflict, 1=corroborate). When conflict_status is 'unknown' no pair was scored and this is the placeholder 1.0 — read it as 'no evidence', NOT as measured corroboration; when conflict_status is 'partial' it is a minimum over the scored subset only. */
|
|
830
843
|
alignment_min: number;
|
|
831
844
|
/** Days between earliest and latest claim in the group */
|
|
832
845
|
temporal_spread_days: number;
|
|
833
|
-
/** True if alignment_min < 0.85, indicating potential conflict */
|
|
846
|
+
/** True if alignment_min < 0.85, indicating potential conflict. Like has_conflict, FALSE IS NOT A CLEAN BILL OF HEALTH unless conflict_status is 'conflict': this is derived from alignment_min, which is the 1.0 placeholder on an 'unknown' group (no pair was scored) and a minimum over the scored subset only on a 'partial' group — so on those groups false means no low-alignment pair was demonstrated among the pairs actually scored, which on an 'unknown' group is none of them. Results covered by such a group carry conflictScoringIncomplete. */
|
|
834
847
|
has_low_alignment_pair: boolean;
|
|
835
|
-
/** True if alignment_min < 0.4 — claims directly conflict or one supersedes the other */
|
|
848
|
+
/** True if alignment_min < 0.4 — claims directly conflict or one supersedes the other. FALSE IS NOT A CLEAN BILL OF HEALTH unless conflict_status is 'conflict': on a 'partial' or 'unknown' group it means no conflict was demonstrated among the pairs that were actually scored, which on an 'unknown' group is none of them. Results covered by such a group carry conflictScoringIncomplete. */
|
|
836
849
|
has_conflict: boolean;
|
|
837
850
|
/** True if temporal_spread_days > 30 */
|
|
838
851
|
has_temporal_spread: boolean;
|
|
@@ -844,6 +857,8 @@ interface ClaimGroup {
|
|
|
844
857
|
claims: ClaimGroupClaim[];
|
|
845
858
|
/** Scoring completeness of the SAMPLED neighbor set (up to the top 20 ALIGNS_WITH edges per claim, by embedding similarity — edges beyond that sample are not evaluated): 'conflict' = all sampled edges scored and a conflict was detected, 'partial' = some sampled edges unscored, 'unknown' = all sampled edges unscored */
|
|
846
859
|
conflict_status: 'conflict' | 'partial' | 'unknown';
|
|
860
|
+
/** How many distinct sampled ALIGNS_WITH pairs in this group were left unscored — the alignment judge was unavailable, the per-request pair cap was reached, the wall-clock scoring budget expired, or a judge response failed to parse. Present only when > 0, i.e. exactly when conflict_status is 'partial' or 'unknown'; ABSENT on a fully-scored group, which gains no new field. Counted over the sampled neighbor set only, so it is a lower bound on unevaluated relationships. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that scoring completed there. */
|
|
861
|
+
unscored_pair_count?: number;
|
|
847
862
|
/** Computed signals about the claim cluster */
|
|
848
863
|
signals: ClaimGroupSignals;
|
|
849
864
|
}
|
|
@@ -1379,6 +1394,10 @@ interface DigestMetadata {
|
|
|
1379
1394
|
narrowWindowFallback?: boolean;
|
|
1380
1395
|
/** True when the digest is in the narrow-window band AND the source memories span 2+ distinct codeContext.product values (or none share a product). Indicates the synthesis is drawn from heterogeneous, possibly cross-project sources — likely the wrong project for the calling agent. See support#183. */
|
|
1381
1396
|
crossProjectFallback?: boolean;
|
|
1397
|
+
/** v2.90 (#5450). True when the fulltext-anchor gate discarded a non-empty candidate set during the gather that produced this digest, so this digest does NOT include everything the search found. Combine with sourcesConsidered: sourcesConsidered=0 alongside this flag means the empty answer is an artefact of the gate, not a statement that the store holds nothing, and a wider maxSources may return results. ABSENT (not false) when the gate suppressed nothing — an unsuppressed response gains no new fields, so existing clients are unaffected. This is an EVENT record, not a verdict on emptiness. This field is emitted by the digest and search responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
1398
|
+
anchorGateSuppressed?: boolean;
|
|
1399
|
+
/** v2.90 (#5450). How many fused candidates the fulltext-anchor gate discarded, summed across every hybrid search this gather ran. Present only alongside anchorGateSuppressed, and always > 0 when present. Treat it as an UPPER BOUND on what a wider maxSources could recover, not as a count of retrievable rows: the gate runs before the superseded/duplicate exclusion, so discarded candidates can include duplicate-state rows that are never served at any maxSources and superseded rows that are served only when the caller asks for them. This field is emitted by the digest and search responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
1400
|
+
anchorGateDiscardedCount?: number;
|
|
1382
1401
|
/** ISO 8601 timestamp when the digest was generated */
|
|
1383
1402
|
generatedAt: string;
|
|
1384
1403
|
/** Recursion stats (only present when recursive synthesis is used) */
|
|
@@ -4581,4 +4600,4 @@ declare class MemNexus {
|
|
|
4581
4600
|
forget(memoryId: string): Promise<HttpResponse<unknown>>;
|
|
4582
4601
|
}
|
|
4583
4602
|
|
|
4584
|
-
export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BranchFailure, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchFailureResponse, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
|
|
4603
|
+
export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BranchFailure, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type ConflictScoringIncomplete, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchFailureResponse, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
|
package/dist/index.d.ts
CHANGED
|
@@ -673,6 +673,13 @@ interface SearchRequest {
|
|
|
673
673
|
/** EXPERIMENTAL — dev-measurement only. Per-request override of the v2.74 Phase B assistant-claims serving flag (env ASSISTANT_CLAIMS_SERVING), used by the eval harness to run treatment (conditional serving) vs control (Phase A exclusion) arms in one pass. Honored ONLY when the server has ASSISTANT_CLAIMS_SERVING_PARAM_ENABLED=true (dev); otherwise silently ignored (no error). true enables Phase B conditional serving (the F20 trigger still decides per-query whether assistant-origin claims surface); false forces Phase A exclusion. Absent → server default. Not for production use. */
|
|
674
674
|
assistantClaimsServing?: boolean;
|
|
675
675
|
}
|
|
676
|
+
/** Present ONLY when at least one of this result's claims sits in a claim group whose conflict check did not complete (v2.91). Conflict detection scores ALIGNS_WITH claim pairs with an LLM judge on the search path; that scoring can be skipped because the judge was unavailable, the per-request pair cap was reached, the wall-clock budget expired, or a judge response failed to parse. When this field is present, the absence of a conflict marker in this result's summary_facts means NO CONFLICT WAS DEMONSTRATED — not that none exists. Cross-reference groupIds against claim_groups[].id for the group's conflict_status. ABSENT (not false, not an empty object) when every sampled pair covering this result was scored — a fully-scored response gains no new field. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that conflict scoring completed there. */
|
|
677
|
+
interface ConflictScoringIncomplete {
|
|
678
|
+
/** Ids of the claim groups covering this result whose conflict scoring did not complete. Each matches a claim_groups[].id in the same response, where conflict_status is 'partial' (some sampled pairs unscored) or 'unknown' (none scored). Never empty when this object is present. */
|
|
679
|
+
groupIds: string[];
|
|
680
|
+
/** Distinct ALIGNS_WITH claim pairs left unscored, summed across groupIds. Present only when > 0. Counted over the SAMPLED neighbor set (up to the top 20 edges per claim by embedding similarity), so it is a lower bound on unevaluated relationships, not a total. Absent when the group carries no count, which does not mean zero. */
|
|
681
|
+
unscoredPairs?: number;
|
|
682
|
+
}
|
|
676
683
|
interface Entity {
|
|
677
684
|
/** Entity name */
|
|
678
685
|
name?: string;
|
|
@@ -708,6 +715,8 @@ interface SearchResult {
|
|
|
708
715
|
effectiveState?: string;
|
|
709
716
|
/** Human-readable caveat present ONLY on results with effectiveState='superseded' (v2.76, #4611). Supersession is session-granular: a memory is marked superseded when ANY fact in it was later updated, so most of its facts are typically still accurate. This notice says the session was partially updated; individual outdated lines in summary_facts are marked [SUPERSEDED] with the newer value quoted inline. Additive and optional — absent on current results, and absent entirely unless SUPERSEDED_RETRIEVAL_MODE='demote'. */
|
|
710
717
|
supersessionNotice?: string;
|
|
718
|
+
/** Present ONLY when at least one of this result's claims sits in a claim group whose conflict check did not complete (v2.91). Conflict detection scores ALIGNS_WITH claim pairs with an LLM judge on the search path; that scoring can be skipped because the judge was unavailable, the per-request pair cap was reached, the wall-clock budget expired, or a judge response failed to parse. When this field is present, the absence of a conflict marker in this result's summary_facts means NO CONFLICT WAS DEMONSTRATED — not that none exists. Cross-reference groupIds against claim_groups[].id for the group's conflict_status. ABSENT (not false, not an empty object) when every sampled pair covering this result was scored — a fully-scored response gains no new field. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that conflict scoring completed there. */
|
|
719
|
+
conflictScoringIncomplete?: ConflictScoringIncomplete;
|
|
711
720
|
/** Confidence score (0-1) */
|
|
712
721
|
confidenceScore?: number;
|
|
713
722
|
/** Overall relevance score for this result */
|
|
@@ -792,6 +801,10 @@ interface SearchMeta {
|
|
|
792
801
|
degraded?: boolean;
|
|
793
802
|
/** The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted, and the field is absent entirely on the healthy path. */
|
|
794
803
|
branchFailures?: BranchFailure[];
|
|
804
|
+
/** True when the fulltext-anchor gate discarded a non-empty candidate set for this query, so this page does NOT include everything the search found. Combine with total: total=0 alongside this flag means the empty result is an artefact of the gate, not a statement that no matching memory exists, and a larger limit may return results. DISTINCT from degraded, which is false here because every search branch succeeded. ABSENT (not false) when the gate suppressed nothing — an unsuppressed response gains no new fields. This field is emitted by the search and digest responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
805
|
+
anchorGateSuppressed?: boolean;
|
|
806
|
+
/** How many fused candidates the fulltext-anchor gate discarded, summed across every hybrid search whose health this request captured; reformulation searches issued under `rewrite=true` are NOT included, so on such a request this count can under-report, and both fields can be absent entirely even though the gate did suppress. Present only alongside anchorGateSuppressed, and always > 0 when present. Treat it as an UPPER BOUND on what a larger limit could recover, not as a count of retrievable rows: the gate runs before the superseded/duplicate exclusion, so discarded candidates can include duplicate-state rows that are never served at any limit and superseded rows that are served only when the caller asks for them. This field is emitted by the search and digest responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
807
|
+
anchorGateDiscardedCount?: number;
|
|
795
808
|
/** Temporal query metadata (present when temporal filters are used) */
|
|
796
809
|
temporalMetadata?: TemporalMetadata;
|
|
797
810
|
}
|
|
@@ -826,13 +839,13 @@ interface ClaimGroupClaim {
|
|
|
826
839
|
interface ClaimGroupSignals {
|
|
827
840
|
/** Number of claims in this group */
|
|
828
841
|
n_claims: number;
|
|
829
|
-
/** Minimum LLM-judged alignment score among
|
|
842
|
+
/** Minimum LLM-judged alignment score among the SCORED pairs in the group (0=conflict, 1=corroborate). When conflict_status is 'unknown' no pair was scored and this is the placeholder 1.0 — read it as 'no evidence', NOT as measured corroboration; when conflict_status is 'partial' it is a minimum over the scored subset only. */
|
|
830
843
|
alignment_min: number;
|
|
831
844
|
/** Days between earliest and latest claim in the group */
|
|
832
845
|
temporal_spread_days: number;
|
|
833
|
-
/** True if alignment_min < 0.85, indicating potential conflict */
|
|
846
|
+
/** True if alignment_min < 0.85, indicating potential conflict. Like has_conflict, FALSE IS NOT A CLEAN BILL OF HEALTH unless conflict_status is 'conflict': this is derived from alignment_min, which is the 1.0 placeholder on an 'unknown' group (no pair was scored) and a minimum over the scored subset only on a 'partial' group — so on those groups false means no low-alignment pair was demonstrated among the pairs actually scored, which on an 'unknown' group is none of them. Results covered by such a group carry conflictScoringIncomplete. */
|
|
834
847
|
has_low_alignment_pair: boolean;
|
|
835
|
-
/** True if alignment_min < 0.4 — claims directly conflict or one supersedes the other */
|
|
848
|
+
/** True if alignment_min < 0.4 — claims directly conflict or one supersedes the other. FALSE IS NOT A CLEAN BILL OF HEALTH unless conflict_status is 'conflict': on a 'partial' or 'unknown' group it means no conflict was demonstrated among the pairs that were actually scored, which on an 'unknown' group is none of them. Results covered by such a group carry conflictScoringIncomplete. */
|
|
836
849
|
has_conflict: boolean;
|
|
837
850
|
/** True if temporal_spread_days > 30 */
|
|
838
851
|
has_temporal_spread: boolean;
|
|
@@ -844,6 +857,8 @@ interface ClaimGroup {
|
|
|
844
857
|
claims: ClaimGroupClaim[];
|
|
845
858
|
/** Scoring completeness of the SAMPLED neighbor set (up to the top 20 ALIGNS_WITH edges per claim, by embedding similarity — edges beyond that sample are not evaluated): 'conflict' = all sampled edges scored and a conflict was detected, 'partial' = some sampled edges unscored, 'unknown' = all sampled edges unscored */
|
|
846
859
|
conflict_status: 'conflict' | 'partial' | 'unknown';
|
|
860
|
+
/** How many distinct sampled ALIGNS_WITH pairs in this group were left unscored — the alignment judge was unavailable, the per-request pair cap was reached, the wall-clock scoring budget expired, or a judge response failed to parse. Present only when > 0, i.e. exactly when conflict_status is 'partial' or 'unknown'; ABSENT on a fully-scored group, which gains no new field. Counted over the sampled neighbor set only, so it is a lower bound on unevaluated relationships. This field is emitted by the search responses that implement it; its absence on any other endpoint carries no assurance that scoring completed there. */
|
|
861
|
+
unscored_pair_count?: number;
|
|
847
862
|
/** Computed signals about the claim cluster */
|
|
848
863
|
signals: ClaimGroupSignals;
|
|
849
864
|
}
|
|
@@ -1379,6 +1394,10 @@ interface DigestMetadata {
|
|
|
1379
1394
|
narrowWindowFallback?: boolean;
|
|
1380
1395
|
/** True when the digest is in the narrow-window band AND the source memories span 2+ distinct codeContext.product values (or none share a product). Indicates the synthesis is drawn from heterogeneous, possibly cross-project sources — likely the wrong project for the calling agent. See support#183. */
|
|
1381
1396
|
crossProjectFallback?: boolean;
|
|
1397
|
+
/** v2.90 (#5450). True when the fulltext-anchor gate discarded a non-empty candidate set during the gather that produced this digest, so this digest does NOT include everything the search found. Combine with sourcesConsidered: sourcesConsidered=0 alongside this flag means the empty answer is an artefact of the gate, not a statement that the store holds nothing, and a wider maxSources may return results. ABSENT (not false) when the gate suppressed nothing — an unsuppressed response gains no new fields, so existing clients are unaffected. This is an EVENT record, not a verdict on emptiness. This field is emitted by the digest and search responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
1398
|
+
anchorGateSuppressed?: boolean;
|
|
1399
|
+
/** v2.90 (#5450). How many fused candidates the fulltext-anchor gate discarded, summed across every hybrid search this gather ran. Present only alongside anchorGateSuppressed, and always > 0 when present. Treat it as an UPPER BOUND on what a wider maxSources could recover, not as a count of retrievable rows: the gate runs before the superseded/duplicate exclusion, so discarded candidates can include duplicate-state rows that are never served at any maxSources and superseded rows that are served only when the caller asks for them. This field is emitted by the digest and search responses that implement it; its absence on any other endpoint carries no assurance that nothing was suppressed there. */
|
|
1400
|
+
anchorGateDiscardedCount?: number;
|
|
1382
1401
|
/** ISO 8601 timestamp when the digest was generated */
|
|
1383
1402
|
generatedAt: string;
|
|
1384
1403
|
/** Recursion stats (only present when recursive synthesis is used) */
|
|
@@ -4581,4 +4600,4 @@ declare class MemNexus {
|
|
|
4581
4600
|
forget(memoryId: string): Promise<HttpResponse<unknown>>;
|
|
4582
4601
|
}
|
|
4583
4602
|
|
|
4584
|
-
export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BranchFailure, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchFailureResponse, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
|
|
4603
|
+
export { type AddMemoryToNarrativeRequest, type ApiKey, type AppendNamedMemoryRequest, type Artifact, type BatchGetMemoriesMeta, type BatchGetMemoriesRequest, type BatchGetMemoriesResponse, type BillingOverview, type BranchFailure, type BuildContextActiveWork, type BuildContextActivity, type BuildContextFact, type BuildContextGotcha, type BuildContextMeta, type BuildContextPattern, type BuildContextRequest, type BuildContextResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkTagRequest, type BulkTagResponse, type BulkUpdateRequest, type BulkUpdateResponse, type CheckoutSessionResponse, type ClaimGroup, type ClaimGroupClaim, type ClaimGroupSignals, type CodeContext, type Community, type CompileInstructionsRequest, type CompileInstructionsResponse, type ConflictScoringIncomplete, type Conversation, type CreateArtifactRequest, type CreateCheckoutSessionRequest, type CreateConversationRequest, type CreateFactRequest, type CreateMemoryRelationshipRequest, type CreateMemoryRequest, type CreateMemoryResponse, type CreateMemoryResponseMeta, type CreateNarrativeRequest, type CreatePortalSessionRequest, type CreateRecommendationRequest, type CreateSystemAlertRequest, type DigestEntity, type DigestKeyFact, type DigestMetadata, type DigestRequest, type DigestResponse, type DigestSource, type DigestTimeRange, type EffectiveStateBreakdown, type Entity, type EntityNode, type Error$1 as Error, type ExportRequest, type FacetEntry, type Facets, type Fact, type FactSearchRequest, type GetMemoryResponse, type GetNarrativeResponse, type GraphRAGQueryRequest, type GraphRAGQueryResponse, type HealthCheck, type HttpClientOptions, type HttpResponse, type Invoice, type ListInvoicesResponse, type ListNarrativesResponse, type ListPaymentMethodsResponse, type MatchRecommendationsRequest, MemNexus, type Memory, type MemoryRelationship, type MemoryRelationshipsResponse, type NamedMemoryHistoryResponse, type NarrativeMemory, type NarrativeThread, type NarrativeTimelineResponse, type Pagination, type Pattern, type PaymentMethod, type PortalSessionResponse, type PrecomputedMemoryFields, type Recommendation, type RelatedMemoryResult, SdkError, type SearchFailureResponse, type SearchMeta, type SearchRequest, type SearchResponse, type SearchResult, type ServiceCheck, type Subscription, type SystemAlert, type TemporalMetadata, type Topic, type UpdateArtifactRequest, type UpdateFactRequest, type UpdateMemoryRequest, type UpdateNamedMemoryRequest, type UpdateNarrativeRequest, type UpdateSystemAlertRequest, type User, type UserUsage };
|