@memnexus-ai/typescript-sdk 1.76.7 → 1.77.0

package/dist/index.cjs

@@ -79,6 +79,7 @@ __export(index_exports, {
   community: () => community,
   compileInstructionsRequest: () => compileInstructionsRequest,
   compileInstructionsResponse: () => compileInstructionsResponse,
+  conflictScoringIncomplete: () => conflictScoringIncomplete,
   conversation: () => conversation,
   createArtifactRequest: () => createArtifactRequest,
   createCheckoutSessionRequest: () => createCheckoutSessionRequest,
@@ -6982,6 +6983,12 @@ var searchRequest = import_zod.z.object({
   /** 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. */
   assistantClaimsServing: import_zod.z.boolean().optional()
 });
+var conflictScoringIncomplete = import_zod.z.object({
+  /** 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. */
+  groupIds: import_zod.z.array(import_zod.z.string()).min(1),
+  /** 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. */
+  unscoredPairs: import_zod.z.number().min(1).optional()
+});
 var entity = import_zod.z.object({
   /** Entity name */
   name: import_zod.z.string().optional(),
@@ -7017,6 +7024,8 @@ var searchResult = import_zod.z.lazy(() => import_zod.z.object({
   effectiveState: import_zod.z.string().optional(),
   /** 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'. */
   supersessionNotice: import_zod.z.string().optional(),
+  /** 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. */
+  conflictScoringIncomplete: conflictScoringIncomplete.optional(),
   /** Confidence score (0-1) */
   confidenceScore: import_zod.z.number().min(0).max(1).optional(),
   /** Overall relevance score for this result */
@@ -7107,6 +7116,10 @@ var searchMeta = import_zod.z.lazy(() => import_zod.z.object({
   degraded: import_zod.z.boolean().optional(),
   /** 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. */
   branchFailures: import_zod.z.array(branchFailure).optional(),
+  /** 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. */
+  anchorGateSuppressed: import_zod.z.boolean().optional(),
+  /** 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. */
+  anchorGateDiscardedCount: import_zod.z.number().min(1).optional(),
   /** Temporal query metadata (present when temporal filters are used) */
   temporalMetadata: temporalMetadata.optional()
 }));
@@ -7139,13 +7152,13 @@ var claimGroupClaim = import_zod.z.object({
 var claimGroupSignals = import_zod.z.object({
   /** Number of claims in this group */
   n_claims: import_zod.z.number(),
-  /** Minimum LLM-judged alignment score among all pairs in the group (0=conflict, 1=corroborate) */
+  /** 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. */
   alignment_min: import_zod.z.number(),
   /** Days between earliest and latest claim in the group */
   temporal_spread_days: import_zod.z.number(),
-  /** True if alignment_min < 0.85, indicating potential conflict */
+  /** 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. */
   has_low_alignment_pair: import_zod.z.boolean(),
-  /** True if alignment_min < 0.4 — claims directly conflict or one supersedes the other */
+  /** 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. */
   has_conflict: import_zod.z.boolean(),
   /** True if temporal_spread_days > 30 */
   has_temporal_spread: import_zod.z.boolean()
@@ -7157,6 +7170,8 @@ var claimGroup = import_zod.z.lazy(() => import_zod.z.object({
   claims: import_zod.z.array(claimGroupClaim),
   /** 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 */
   conflict_status: import_zod.z.enum(["conflict", "partial", "unknown"]),
+  /** 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. */
+  unscored_pair_count: import_zod.z.number().min(1).optional(),
   /** Computed signals about the claim cluster */
   signals: claimGroupSignals
 }));
@@ -7769,6 +7784,10 @@ var digestMetadata = import_zod.z.lazy(() => import_zod.z.object({
   narrowWindowFallback: import_zod.z.boolean().optional(),
   /** 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. */
   crossProjectFallback: import_zod.z.boolean().optional(),
+  /** 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. */
+  anchorGateSuppressed: import_zod.z.boolean().optional(),
+  /** 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. */
+  anchorGateDiscardedCount: import_zod.z.number().min(1).optional(),
   /** ISO 8601 timestamp when the digest was generated */
   generatedAt: import_zod.z.string().datetime(),
   /** Recursion stats (only present when recursive synthesis is used) */
@@ -8271,6 +8290,7 @@ var index_default = Memnexus;
   community,
   compileInstructionsRequest,
   compileInstructionsResponse,
+  conflictScoringIncomplete,
   conversation,
   createArtifactRequest,
   createCheckoutSessionRequest,