@tenphi/akno-protocol 0.4.0 → 0.5.0

package/dist/ops/retain.d.ts

@@ -40,10 +40,10 @@ export declare const RetainedTime: z.ZodObject<{
         due: "due";
     }>;
     status: z.ZodEnum<{
+        tentative: "tentative";
         planned: "planned";
         scheduled: "scheduled";
         actual: "actual";
-        tentative: "tentative";
     }>;
     timezone: z.ZodOptional<z.ZodString>;
     mentioned_at: z.ZodOptional<z.ZodString>;
@@ -95,10 +95,10 @@ export declare const ProvidedRetainCandidate: z.ZodObject<{
     kind: z.ZodEnum<{
         question: "question";
         claim: "claim";
-        event: "event";
-        plan: "plan";
         decision: "decision";
         preference: "preference";
+        plan: "plan";
+        event: "event";
     }>;
     text: z.ZodString;
     subject: z.ZodString;
@@ -126,20 +126,20 @@ export declare const ProvidedRetainCandidate: z.ZodObject<{
     discourse: z.ZodObject<{
         commitment: z.ZodEnum<{
             none: "none";
-            tentative: "tentative";
             asserted: "asserted";
+            tentative: "tentative";
             hypothetical: "hypothetical";
             counterfactual: "counterfactual";
         }>;
         disposition: z.ZodEnum<{
-            superseded: "superseded";
-            rejected: "rejected";
-            completed: "completed";
-            proposed: "proposed";
             active: "active";
+            proposed: "proposed";
             accepted: "accepted";
+            rejected: "rejected";
             resolved: "resolved";
             cancelled: "cancelled";
+            completed: "completed";
+            superseded: "superseded";
         }>;
     }, z.core.$strip>;
     epistemic: z.ZodObject<{
@@ -210,10 +210,10 @@ export declare const ProvidedRetainCandidate: z.ZodObject<{
             due: "due";
         }>;
         status: z.ZodEnum<{
+            tentative: "tentative";
             planned: "planned";
             scheduled: "scheduled";
             actual: "actual";
-            tentative: "tentative";
         }>;
         timezone: z.ZodOptional<z.ZodString>;
         mentioned_at: z.ZodOptional<z.ZodString>;
@@ -237,10 +237,10 @@ export declare const ProvidedRetainCandidate: z.ZodObject<{
             until: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    destination: z.ZodObject<{
+    destination: z.ZodOptional<z.ZodObject<{
         slug: z.ZodString;
         section: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProvidedRetainCandidate = z.infer<typeof ProvidedRetainCandidate>;
 export declare const RetainSourceItem: z.ZodObject<{
@@ -285,18 +285,21 @@ export declare const RetainUpsertSource: z.ZodObject<{
             mentioned_at: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>;
-    retention: z.ZodObject<{
+    retention: z.ZodUnion<readonly [z.ZodObject<{
         mode: z.ZodLiteral<"provided">;
-        placement: z.ZodLiteral<"exact">;
+        placement: z.ZodEnum<{
+            exact: "exact";
+            automatic: "automatic";
+        }>;
         candidates: z.ZodArray<z.ZodObject<{
             candidate_id: z.ZodString;
             kind: z.ZodEnum<{
                 question: "question";
                 claim: "claim";
-                event: "event";
-                plan: "plan";
                 decision: "decision";
                 preference: "preference";
+                plan: "plan";
+                event: "event";
             }>;
             text: z.ZodString;
             subject: z.ZodString;
@@ -324,20 +327,20 @@ export declare const RetainUpsertSource: z.ZodObject<{
             discourse: z.ZodObject<{
                 commitment: z.ZodEnum<{
                     none: "none";
-                    tentative: "tentative";
                     asserted: "asserted";
+                    tentative: "tentative";
                     hypothetical: "hypothetical";
                     counterfactual: "counterfactual";
                 }>;
                 disposition: z.ZodEnum<{
-                    superseded: "superseded";
-                    rejected: "rejected";
-                    completed: "completed";
-                    proposed: "proposed";
                     active: "active";
+                    proposed: "proposed";
                     accepted: "accepted";
+                    rejected: "rejected";
                     resolved: "resolved";
                     cancelled: "cancelled";
+                    completed: "completed";
+                    superseded: "superseded";
                 }>;
             }, z.core.$strip>;
             epistemic: z.ZodObject<{
@@ -408,10 +411,10 @@ export declare const RetainUpsertSource: z.ZodObject<{
                     due: "due";
                 }>;
                 status: z.ZodEnum<{
+                    tentative: "tentative";
                     planned: "planned";
                     scheduled: "scheduled";
                     actual: "actual";
-                    tentative: "tentative";
                 }>;
                 timezone: z.ZodOptional<z.ZodString>;
                 mentioned_at: z.ZodOptional<z.ZodString>;
@@ -435,12 +438,15 @@ export declare const RetainUpsertSource: z.ZodObject<{
                     until: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
-            destination: z.ZodObject<{
+            destination: z.ZodOptional<z.ZodObject<{
                 slug: z.ZodString;
                 section: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"extract">;
+        mission: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>;
     source_id: z.ZodString;
     revision: z.ZodString;
 }, z.core.$strip>;
@@ -490,18 +496,21 @@ export declare const RetainInput: z.ZodObject<{
                 mentioned_at: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>]>;
-        retention: z.ZodObject<{
+        retention: z.ZodUnion<readonly [z.ZodObject<{
             mode: z.ZodLiteral<"provided">;
-            placement: z.ZodLiteral<"exact">;
+            placement: z.ZodEnum<{
+                exact: "exact";
+                automatic: "automatic";
+            }>;
             candidates: z.ZodArray<z.ZodObject<{
                 candidate_id: z.ZodString;
                 kind: z.ZodEnum<{
                     question: "question";
                     claim: "claim";
-                    event: "event";
-                    plan: "plan";
                     decision: "decision";
                     preference: "preference";
+                    plan: "plan";
+                    event: "event";
                 }>;
                 text: z.ZodString;
                 subject: z.ZodString;
@@ -529,20 +538,20 @@ export declare const RetainInput: z.ZodObject<{
                 discourse: z.ZodObject<{
                     commitment: z.ZodEnum<{
                         none: "none";
-                        tentative: "tentative";
                         asserted: "asserted";
+                        tentative: "tentative";
                         hypothetical: "hypothetical";
                         counterfactual: "counterfactual";
                     }>;
                     disposition: z.ZodEnum<{
-                        superseded: "superseded";
-                        rejected: "rejected";
-                        completed: "completed";
-                        proposed: "proposed";
                         active: "active";
+                        proposed: "proposed";
                         accepted: "accepted";
+                        rejected: "rejected";
                         resolved: "resolved";
                         cancelled: "cancelled";
+                        completed: "completed";
+                        superseded: "superseded";
                     }>;
                 }, z.core.$strip>;
                 epistemic: z.ZodObject<{
@@ -613,10 +622,10 @@ export declare const RetainInput: z.ZodObject<{
                         due: "due";
                     }>;
                     status: z.ZodEnum<{
+                        tentative: "tentative";
                         planned: "planned";
                         scheduled: "scheduled";
                         actual: "actual";
-                        tentative: "tentative";
                     }>;
                     timezone: z.ZodOptional<z.ZodString>;
                     mentioned_at: z.ZodOptional<z.ZodString>;
@@ -640,12 +649,15 @@ export declare const RetainInput: z.ZodObject<{
                         until: z.ZodOptional<z.ZodString>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
-                destination: z.ZodObject<{
+                destination: z.ZodOptional<z.ZodObject<{
                     slug: z.ZodString;
                     section: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            mode: z.ZodLiteral<"extract">;
+            mission: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>;
         source_id: z.ZodString;
         revision: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -665,6 +677,30 @@ export declare const RetainInput: z.ZodObject<{
     dry_run: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type RetainInput = z.infer<typeof RetainInput>;
+export declare const RetainHoldReason: z.ZodEnum<{
+    conflict: "conflict";
+    routing_uncertain: "routing_uncertain";
+    no_writable_destination: "no_writable_destination";
+    source_unavailable: "source_unavailable";
+    discourse_uncertain: "discourse_uncertain";
+    context_too_large: "context_too_large";
+    time_unresolved: "time_unresolved";
+    noncanonical_without_context: "noncanonical_without_context";
+    support_limit: "support_limit";
+    placement_degraded: "placement_degraded";
+    apply_failed: "apply_failed";
+    validation_failed: "validation_failed";
+}>;
+export type RetainHoldReason = z.infer<typeof RetainHoldReason>;
+/** Content-free receipt for one automatic-retention model request. */
+export declare const RetainModelCallReceipt: z.ZodObject<{
+    model: z.ZodString;
+    latency_ms: z.ZodNumber;
+    input_tokens: z.ZodNullable<z.ZodNumber>;
+    output_tokens: z.ZodNullable<z.ZodNumber>;
+    total_tokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type RetainModelCallReceipt = z.infer<typeof RetainModelCallReceipt>;
 export declare const RetainCandidateResult: z.ZodObject<{
     candidate_id: z.ZodString;
     outcome: z.ZodEnum<{
@@ -677,6 +713,20 @@ export declare const RetainCandidateResult: z.ZodObject<{
     }>;
     memory_id: z.ZodOptional<z.ZodString>;
     slug: z.ZodOptional<z.ZodString>;
+    reason_code: z.ZodOptional<z.ZodEnum<{
+        conflict: "conflict";
+        routing_uncertain: "routing_uncertain";
+        no_writable_destination: "no_writable_destination";
+        source_unavailable: "source_unavailable";
+        discourse_uncertain: "discourse_uncertain";
+        context_too_large: "context_too_large";
+        time_unresolved: "time_unresolved";
+        noncanonical_without_context: "noncanonical_without_context";
+        support_limit: "support_limit";
+        placement_degraded: "placement_degraded";
+        apply_failed: "apply_failed";
+        validation_failed: "validation_failed";
+    }>>;
     reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type RetainCandidateResult = z.infer<typeof RetainCandidateResult>;
@@ -703,8 +753,90 @@ export declare const RetainSourceResult: z.ZodObject<{
         }>;
         memory_id: z.ZodOptional<z.ZodString>;
         slug: z.ZodOptional<z.ZodString>;
+        reason_code: z.ZodOptional<z.ZodEnum<{
+            conflict: "conflict";
+            routing_uncertain: "routing_uncertain";
+            no_writable_destination: "no_writable_destination";
+            source_unavailable: "source_unavailable";
+            discourse_uncertain: "discourse_uncertain";
+            context_too_large: "context_too_large";
+            time_unresolved: "time_unresolved";
+            noncanonical_without_context: "noncanonical_without_context";
+            support_limit: "support_limit";
+            placement_degraded: "placement_degraded";
+            apply_failed: "apply_failed";
+            validation_failed: "validation_failed";
+        }>>;
         reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    reason_code: z.ZodOptional<z.ZodEnum<{
+        conflict: "conflict";
+        routing_uncertain: "routing_uncertain";
+        no_writable_destination: "no_writable_destination";
+        source_unavailable: "source_unavailable";
+        discourse_uncertain: "discourse_uncertain";
+        context_too_large: "context_too_large";
+        time_unresolved: "time_unresolved";
+        noncanonical_without_context: "noncanonical_without_context";
+        support_limit: "support_limit";
+        placement_degraded: "placement_degraded";
+        apply_failed: "apply_failed";
+        validation_failed: "validation_failed";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        retain_verification_failed: "retain_verification_failed";
+        retain_apply_failed: "retain_apply_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    model_usage: z.ZodOptional<z.ZodObject<{
+        extraction: z.ZodNullable<z.ZodObject<{
+            model: z.ZodString;
+            latency_ms: z.ZodNumber;
+            input_tokens: z.ZodNullable<z.ZodNumber>;
+            output_tokens: z.ZodNullable<z.ZodNumber>;
+            total_tokens: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        verification: z.ZodNullable<z.ZodObject<{
+            model: z.ZodString;
+            latency_ms: z.ZodNumber;
+            input_tokens: z.ZodNullable<z.ZodNumber>;
+            output_tokens: z.ZodNullable<z.ZodNumber>;
+            total_tokens: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        placement: z.ZodArray<z.ZodObject<{
+            model: z.ZodString;
+            latency_ms: z.ZodNumber;
+            input_tokens: z.ZodNullable<z.ZodNumber>;
+            output_tokens: z.ZodNullable<z.ZodNumber>;
+            total_tokens: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type RetainSourceResult = z.infer<typeof RetainSourceResult>;
@@ -723,6 +855,8 @@ export declare const RetainOutput: z.ZodObject<{
         embedding_failed: "embedding_failed";
         rerank_failed: "rerank_failed";
         derive_failed: "derive_failed";
+        retain_verification_failed: "retain_verification_failed";
+        retain_apply_failed: "retain_apply_failed";
         expansion_failed: "expansion_failed";
         no_vector_index: "no_vector_index";
         partial_index: "partial_index";
@@ -767,8 +901,90 @@ export declare const RetainOutput: z.ZodObject<{
             }>;
             memory_id: z.ZodOptional<z.ZodString>;
             slug: z.ZodOptional<z.ZodString>;
+            reason_code: z.ZodOptional<z.ZodEnum<{
+                conflict: "conflict";
+                routing_uncertain: "routing_uncertain";
+                no_writable_destination: "no_writable_destination";
+                source_unavailable: "source_unavailable";
+                discourse_uncertain: "discourse_uncertain";
+                context_too_large: "context_too_large";
+                time_unresolved: "time_unresolved";
+                noncanonical_without_context: "noncanonical_without_context";
+                support_limit: "support_limit";
+                placement_degraded: "placement_degraded";
+                apply_failed: "apply_failed";
+                validation_failed: "validation_failed";
+            }>>;
             reason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        reason_code: z.ZodOptional<z.ZodEnum<{
+            conflict: "conflict";
+            routing_uncertain: "routing_uncertain";
+            no_writable_destination: "no_writable_destination";
+            source_unavailable: "source_unavailable";
+            discourse_uncertain: "discourse_uncertain";
+            context_too_large: "context_too_large";
+            time_unresolved: "time_unresolved";
+            noncanonical_without_context: "noncanonical_without_context";
+            support_limit: "support_limit";
+            placement_degraded: "placement_degraded";
+            apply_failed: "apply_failed";
+            validation_failed: "validation_failed";
+        }>>;
+        status: z.ZodOptional<z.ZodEnum<{
+            ok: "ok";
+            empty: "empty";
+            degraded: "degraded";
+            unavailable: "unavailable";
+        }>>;
+        degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            no_embedding_model: "no_embedding_model";
+            no_reranker: "no_reranker";
+            no_derive_model: "no_derive_model";
+            no_expansion_model: "no_expansion_model";
+            embedding_failed: "embedding_failed";
+            rerank_failed: "rerank_failed";
+            derive_failed: "derive_failed";
+            retain_verification_failed: "retain_verification_failed";
+            retain_apply_failed: "retain_apply_failed";
+            expansion_failed: "expansion_failed";
+            no_vector_index: "no_vector_index";
+            partial_index: "partial_index";
+            no_document_text: "no_document_text";
+            document_source_missing: "document_source_missing";
+            no_graph_index: "no_graph_index";
+            no_entity_index: "no_entity_index";
+            entity_resolution_failed: "entity_resolution_failed";
+            partial_graph_index: "partial_graph_index";
+            graph_traversal_limited: "graph_traversal_limited";
+            no_answer_model: "no_answer_model";
+            answer_failed: "answer_failed";
+            answer_verification_failed: "answer_verification_failed";
+            answer_truncated: "answer_truncated";
+        }>>>;
+        model_usage: z.ZodOptional<z.ZodObject<{
+            extraction: z.ZodNullable<z.ZodObject<{
+                model: z.ZodString;
+                latency_ms: z.ZodNumber;
+                input_tokens: z.ZodNullable<z.ZodNumber>;
+                output_tokens: z.ZodNullable<z.ZodNumber>;
+                total_tokens: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+            verification: z.ZodNullable<z.ZodObject<{
+                model: z.ZodString;
+                latency_ms: z.ZodNumber;
+                input_tokens: z.ZodNullable<z.ZodNumber>;
+                output_tokens: z.ZodNullable<z.ZodNumber>;
+                total_tokens: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+            placement: z.ZodArray<z.ZodObject<{
+                model: z.ZodString;
+                latency_ms: z.ZodNumber;
+                input_tokens: z.ZodNullable<z.ZodNumber>;
+                output_tokens: z.ZodNullable<z.ZodNumber>;
+                total_tokens: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
         note: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/ops/retain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retain.d.ts","sourceRoot":"","sources":["../../src/ops/retain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retain.d.ts","sourceRoot":"","sources":["../../src/ops/retain.ts"],"names":[],"mappings":"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"}

package/dist/ops/retain.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ResultEnvelope } from "../common.js";
+import { DegradedReason, ResultEnvelope } from "../common.js";
 const RetainRef = z.string().min(1).max(300);
 export const RetainSourceRole = z.enum(['user', 'assistant', 'external', 'unknown']);
 export const RetainSourceSpan = z.object({
@@ -165,7 +165,13 @@ export const ProvidedRetainCandidate = z
     discourse_frame: z.array(RetainSourceSpan).min(1).max(16),
     relations: z.array(RetainedRelation).max(8).optional(),
     time: RetainedTime.optional(),
-    destination: z.object({ slug: z.string().min(1), section: z.string().min(1).max(100).optional() }),
+    /**
+     * Required by `provided + exact`; optional as a bounded taxonomy suggestion for automatic
+     * placement. Extraction never grants this suggestion write authority.
+     */
+    destination: z
+        .object({ slug: z.string().min(1), section: z.string().min(1).max(100).optional() })
+        .optional(),
 })
     .superRefine((candidate, ctx) => {
     const allowed = {
@@ -228,20 +234,37 @@ export const RetainUpsertSource = z
         z.object({ text: z.string().min(1).max(500_000) }),
         z.object({ items: z.array(RetainSourceItem).min(1).max(500) }),
     ]),
-    retention: z.object({
-        mode: z.literal('provided'),
-        placement: z.literal('exact'),
-        candidates: z.array(ProvidedRetainCandidate).min(1).max(50),
-    }),
+    retention: z.union([
+        z.object({
+            mode: z.literal('provided'),
+            placement: z.enum(['exact', 'automatic']),
+            candidates: z.array(ProvidedRetainCandidate).min(1).max(50),
+        }),
+        z.object({
+            mode: z.literal('extract'),
+            /** Additive source-specific emphasis; it never replaces the fixed retention policy. */
+            mission: z.string().max(2000).optional(),
+        }),
+    ]),
 })
     .superRefine((source, ctx) => {
-    const candidateIds = source.retention.candidates.map((candidate) => candidate.candidate_id);
-    if (new Set(candidateIds).size !== candidateIds.length) {
-        ctx.addIssue({
-            code: 'custom',
-            path: ['retention', 'candidates'],
-            message: 'candidate ids must be unique within one source revision',
-        });
+    if (source.retention.mode === 'provided') {
+        const candidateIds = source.retention.candidates.map((candidate) => candidate.candidate_id);
+        if (new Set(candidateIds).size !== candidateIds.length) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['retention', 'candidates'],
+                message: 'candidate ids must be unique within one source revision',
+            });
+        }
+        if (source.retention.placement === 'exact' &&
+            source.retention.candidates.some((candidate) => candidate.destination === undefined)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['retention', 'candidates'],
+                message: 'provided exact candidates require a destination',
+            });
+        }
     }
     if ('items' in source.input) {
         const itemIds = source.input.items.map((item) => item.item_id);
@@ -270,11 +293,34 @@ export const RetainInput = z.object({
         .max(20),
     dry_run: z.boolean().optional(),
 });
+export const RetainHoldReason = z.enum([
+    'source_unavailable',
+    'discourse_uncertain',
+    'context_too_large',
+    'time_unresolved',
+    'noncanonical_without_context',
+    'no_writable_destination',
+    'routing_uncertain',
+    'conflict',
+    'support_limit',
+    'placement_degraded',
+    'apply_failed',
+    'validation_failed',
+]);
+/** Content-free receipt for one automatic-retention model request. */
+export const RetainModelCallReceipt = z.object({
+    model: z.string(),
+    latency_ms: z.number().nonnegative(),
+    input_tokens: z.number().int().nonnegative().nullable(),
+    output_tokens: z.number().int().nonnegative().nullable(),
+    total_tokens: z.number().int().nonnegative().nullable(),
+});
 export const RetainCandidateResult = z.object({
     candidate_id: z.string(),
     outcome: z.enum(['written', 'duplicate', 'support_added', 'retracted', 'held', 'not_found']),
     memory_id: z.string().optional(),
     slug: z.string().optional(),
+    reason_code: RetainHoldReason.optional(),
     reason: z.string().optional(),
 });
 export const RetainSourceResult = z.object({
@@ -283,6 +329,17 @@ export const RetainSourceResult = z.object({
     outcome: z.enum(['ok', 'replayed', 'noop', 'held', 'revision_conflict']),
     change_id: z.string().optional(),
     candidates: z.array(RetainCandidateResult),
+    /** Source-level hold when no safe candidate boundary exists yet. */
+    reason_code: RetainHoldReason.optional(),
+    status: z.enum(['ok', 'empty', 'degraded', 'unavailable']).optional(),
+    degraded: z.array(DegradedReason).optional(),
+    model_usage: z
+        .object({
+        extraction: RetainModelCallReceipt.nullable(),
+        verification: RetainModelCallReceipt.nullable(),
+        placement: z.array(RetainModelCallReceipt),
+    })
+        .optional(),
     note: z.string().optional(),
 });
 export const RetainOutput = ResultEnvelope.extend({