@memnexus-ai/typescript-sdk 1.67.3 → 1.68.1

package/dist/index.d.cts

@@ -7743,6 +7743,25 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
     format: z.ZodEnum<["structured", "narrative", "timeline", "status-report"]>;
     /** Average relevance score (0-1) of the source memories used in synthesis. Low values (<0.02) indicate the query may not have strong matches. */
     averageRelevance: z.ZodOptional<z.ZodNumber>;
+    /** PR-3 loud failures. True when the gather that produced this digest was INCOMPLETE — at least one search branch timed out or errored. A degraded digest may under-report: absence of a memory here does not mean it does not exist. Degraded digests are never cached. Absent/false means the gather ran every branch to completion, so a zero-result digest is a genuine 'no matches'. */
+    degraded: z.ZodOptional<z.ZodBoolean>;
+    /** PR-3 loud failures. The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted. */
+    branchFailures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Search branch name (fulltext, semantic, topic, …) */
+        name: z.ZodString;
+        /** How the branch failed */
+        status: z.ZodEnum<["timeout", "error"]>;
+        /** Error message when status is 'error'. Message only, never a stack. */
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }, {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }>, "many">>;
     /** True when averageRelevance falls in the narrow-window band (>= DIGEST_RELEVANCE_THRESHOLD but < NARROW_WINDOW_FALLBACK_CEILING) — the digest synthesised from weak matches that may not represent strong context. Consumers should surface a warning to the calling agent. */
     narrowWindowFallback: z.ZodOptional<z.ZodBoolean>;
     /** 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. */
@@ -7781,7 +7800,13 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
         latest: string;
     } | null;
     generatedAt: string;
+    degraded?: boolean | undefined;
     averageRelevance?: number | undefined;
+    branchFailures?: {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }[] | undefined;
     narrowWindowFallback?: boolean | undefined;
     crossProjectFallback?: boolean | undefined;
     recursion?: {
@@ -7801,7 +7826,13 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
         latest: string;
     } | null;
     generatedAt: string;
+    degraded?: boolean | undefined;
     averageRelevance?: number | undefined;
+    branchFailures?: {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }[] | undefined;
     narrowWindowFallback?: boolean | undefined;
     crossProjectFallback?: boolean | undefined;
     recursion?: {
@@ -7908,6 +7939,25 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
         format: z.ZodEnum<["structured", "narrative", "timeline", "status-report"]>;
         /** Average relevance score (0-1) of the source memories used in synthesis. Low values (<0.02) indicate the query may not have strong matches. */
         averageRelevance: z.ZodOptional<z.ZodNumber>;
+        /** PR-3 loud failures. True when the gather that produced this digest was INCOMPLETE — at least one search branch timed out or errored. A degraded digest may under-report: absence of a memory here does not mean it does not exist. Degraded digests are never cached. Absent/false means the gather ran every branch to completion, so a zero-result digest is a genuine 'no matches'. */
+        degraded: z.ZodOptional<z.ZodBoolean>;
+        /** PR-3 loud failures. The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted. */
+        branchFailures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Search branch name (fulltext, semantic, topic, …) */
+            name: z.ZodString;
+            /** How the branch failed */
+            status: z.ZodEnum<["timeout", "error"]>;
+            /** Error message when status is 'error'. Message only, never a stack. */
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }, {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }>, "many">>;
         /** True when averageRelevance falls in the narrow-window band (>= DIGEST_RELEVANCE_THRESHOLD but < NARROW_WINDOW_FALLBACK_CEILING) — the digest synthesised from weak matches that may not represent strong context. Consumers should surface a warning to the calling agent. */
         narrowWindowFallback: z.ZodOptional<z.ZodBoolean>;
         /** 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. */
@@ -7946,7 +7996,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -7966,7 +8022,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -8335,7 +8397,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -8443,7 +8511,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {

package/dist/index.d.ts

@@ -7743,6 +7743,25 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
     format: z.ZodEnum<["structured", "narrative", "timeline", "status-report"]>;
     /** Average relevance score (0-1) of the source memories used in synthesis. Low values (<0.02) indicate the query may not have strong matches. */
     averageRelevance: z.ZodOptional<z.ZodNumber>;
+    /** PR-3 loud failures. True when the gather that produced this digest was INCOMPLETE — at least one search branch timed out or errored. A degraded digest may under-report: absence of a memory here does not mean it does not exist. Degraded digests are never cached. Absent/false means the gather ran every branch to completion, so a zero-result digest is a genuine 'no matches'. */
+    degraded: z.ZodOptional<z.ZodBoolean>;
+    /** PR-3 loud failures. The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted. */
+    branchFailures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Search branch name (fulltext, semantic, topic, …) */
+        name: z.ZodString;
+        /** How the branch failed */
+        status: z.ZodEnum<["timeout", "error"]>;
+        /** Error message when status is 'error'. Message only, never a stack. */
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }, {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }>, "many">>;
     /** True when averageRelevance falls in the narrow-window band (>= DIGEST_RELEVANCE_THRESHOLD but < NARROW_WINDOW_FALLBACK_CEILING) — the digest synthesised from weak matches that may not represent strong context. Consumers should surface a warning to the calling agent. */
     narrowWindowFallback: z.ZodOptional<z.ZodBoolean>;
     /** 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. */
@@ -7781,7 +7800,13 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
         latest: string;
     } | null;
     generatedAt: string;
+    degraded?: boolean | undefined;
     averageRelevance?: number | undefined;
+    branchFailures?: {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }[] | undefined;
     narrowWindowFallback?: boolean | undefined;
     crossProjectFallback?: boolean | undefined;
     recursion?: {
@@ -7801,7 +7826,13 @@ declare const digestMetadata: z.ZodLazy<z.ZodObject<{
         latest: string;
     } | null;
     generatedAt: string;
+    degraded?: boolean | undefined;
     averageRelevance?: number | undefined;
+    branchFailures?: {
+        status: "error" | "timeout";
+        name: string;
+        error?: string | undefined;
+    }[] | undefined;
     narrowWindowFallback?: boolean | undefined;
     crossProjectFallback?: boolean | undefined;
     recursion?: {
@@ -7908,6 +7939,25 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
         format: z.ZodEnum<["structured", "narrative", "timeline", "status-report"]>;
         /** Average relevance score (0-1) of the source memories used in synthesis. Low values (<0.02) indicate the query may not have strong matches. */
         averageRelevance: z.ZodOptional<z.ZodNumber>;
+        /** PR-3 loud failures. True when the gather that produced this digest was INCOMPLETE — at least one search branch timed out or errored. A degraded digest may under-report: absence of a memory here does not mean it does not exist. Degraded digests are never cached. Absent/false means the gather ran every branch to completion, so a zero-result digest is a genuine 'no matches'. */
+        degraded: z.ZodOptional<z.ZodBoolean>;
+        /** PR-3 loud failures. The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted. */
+        branchFailures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Search branch name (fulltext, semantic, topic, …) */
+            name: z.ZodString;
+            /** How the branch failed */
+            status: z.ZodEnum<["timeout", "error"]>;
+            /** Error message when status is 'error'. Message only, never a stack. */
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }, {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }>, "many">>;
         /** True when averageRelevance falls in the narrow-window band (>= DIGEST_RELEVANCE_THRESHOLD but < NARROW_WINDOW_FALLBACK_CEILING) — the digest synthesised from weak matches that may not represent strong context. Consumers should surface a warning to the calling agent. */
         narrowWindowFallback: z.ZodOptional<z.ZodBoolean>;
         /** 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. */
@@ -7946,7 +7996,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -7966,7 +8022,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -8335,7 +8397,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {
@@ -8443,7 +8511,13 @@ declare const digestResponse: z.ZodLazy<z.ZodObject<{
             latest: string;
         } | null;
         generatedAt: string;
+        degraded?: boolean | undefined;
         averageRelevance?: number | undefined;
+        branchFailures?: {
+            status: "error" | "timeout";
+            name: string;
+            error?: string | undefined;
+        }[] | undefined;
         narrowWindowFallback?: boolean | undefined;
         crossProjectFallback?: boolean | undefined;
         recursion?: {

package/dist/index.js

@@ -7444,6 +7444,17 @@ var digestMetadata = z.lazy(() => z.object({
   format: z.enum(["structured", "narrative", "timeline", "status-report"]),
   /** Average relevance score (0-1) of the source memories used in synthesis. Low values (<0.02) indicate the query may not have strong matches. */
   averageRelevance: z.number().min(0).max(1).optional(),
+  /** PR-3 loud failures. True when the gather that produced this digest was INCOMPLETE — at least one search branch timed out or errored. A degraded digest may under-report: absence of a memory here does not mean it does not exist. Degraded digests are never cached. Absent/false means the gather ran every branch to completion, so a zero-result digest is a genuine 'no matches'. */
+  degraded: z.boolean().optional(),
+  /** PR-3 loud failures. The branches that did NOT complete, present only when degraded is true. Healthy branches are omitted. */
+  branchFailures: z.array(z.object({
+    /** Search branch name (fulltext, semantic, topic, …) */
+    name: z.string(),
+    /** How the branch failed */
+    status: z.enum(["timeout", "error"]),
+    /** Error message when status is 'error'. Message only, never a stack. */
+    error: z.string().optional()
+  })).optional(),
   /** True when averageRelevance falls in the narrow-window band (>= DIGEST_RELEVANCE_THRESHOLD but < NARROW_WINDOW_FALLBACK_CEILING) — the digest synthesised from weak matches that may not represent strong context. Consumers should surface a warning to the calling agent. */
   narrowWindowFallback: 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. */