@memnexus-ai/typescript-sdk 1.68.8 → 1.70.0

package/dist/index.js

@@ -6814,6 +6814,14 @@ var searchResult = z.lazy(() => z.object({
     contributingFactors: z.array(z.string()).optional()
   }).optional()
 }));
+var branchFailure = z.object({
+  /** Search branch name (fulltext, semantic, topic, digest, …) */
+  name: z.string(),
+  /** How the branch failed */
+  status: z.enum(["timeout", "error"]),
+  /** Closed-vocabulary cause. Never free text — a raw message could leak internal hostnames, ports, or query text. */
+  reason: z.enum(["timeout", "connection", "query_error", "provider_error", "unknown"])
+});
 var temporalMetadata = z.object({
   /** Temporal query mode used */
   temporalMode: z.string(),
@@ -6847,6 +6855,10 @@ var searchMeta = z.lazy(() => z.object({
   searchTime: z.number(),
   /** Search method used for this query */
   searchMethod: z.string(),
+  /** True when this result set is INCOMPLETE — at least one search branch timed out or errored, so absence of a memory does not mean it does not exist. ABSENT (not false) on the healthy path: a healthy response gains no new fields. */
+  degraded: 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: z.array(branchFailure).optional(),
   /** Temporal query metadata (present when temporal filters are used) */
   temporalMetadata: temporalMetadata.optional()
 }));
@@ -6912,6 +6924,20 @@ var searchResponse = z.lazy(() => z.object({
   /** Clusters of related claims that may conflict. Only present when relevant groups exist. Claims within each group are sorted newest-first. */
   claim_groups: z.array(claimGroup).optional()
 }));
+var searchFailureResponse = z.lazy(() => z.object({
+  /** Human-readable message. Worded so it never reads as 'no results exist'. */
+  error: z.string(),
+  /** Top-level outcome the client switches on. all_branches_failed = every search branch failed, backend degraded (a retry may not help until it recovers); deadline_exceeded = the in-app request deadline was hit before a result could be produced (a retry may land inside budget); service_at_capacity = the request was shed by bounded admission/backpressure (retrying after retry_after_ms succeeds once load drops). */
+  reason: z.enum(["all_branches_failed", "deadline_exceeded", "service_at_capacity"]).optional(),
+  /** Explicit signal that retrying is worthwhile. True for all typed honest-failure reasons. */
+  retryable: z.boolean().optional(),
+  /** Advisory delay in milliseconds before retrying. Present only when reason is service_at_capacity. Carries server-side jitter (base ±25%) so clients shed together do not retry in lockstep and re-create the spike. */
+  retry_after_ms: z.number().min(0).optional(),
+  /** True when the gather was incomplete — at least one search branch timed out or errored. */
+  degraded: z.boolean().optional(),
+  /** The branches that did NOT complete. Healthy branches are omitted. */
+  branchFailures: z.array(branchFailure).optional()
+}));
 var fact = z.object({
   /** Unique identifier for the fact */
   id: z.string(),
@@ -7956,6 +7982,7 @@ export {
   batchGetMemoriesRequest,
   batchGetMemoriesResponse,
   billingOverview,
+  branchFailure,
   buildContextActiveWork,
   buildContextActivity,
   buildContextFact,
@@ -8032,6 +8059,7 @@ export {
   precomputedMemoryFields,
   recommendation,
   relatedMemoryResult,
+  searchFailureResponse,
   searchMeta,
   searchRequest,
   searchResponse,