@kodax-ai/kodax 0.7.77 → 0.7.78

package/dist/types-chunks/{types-LanCEDj8.d.ts → types-D3g6XUQr.d.ts}

@@ -86,26 +86,47 @@ interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
 interface KodaXMemoryOutcomeDigest {
     readonly id: string;
     readonly reviewKey: string;
+    /** Stable root-episode identity; absent on pre-F263 digests. */
+    readonly episodeId?: string;
     readonly sessionId: string;
     readonly branchId: string;
     readonly sequence: number;
     readonly objective: string;
     readonly actionSignature?: string;
     readonly approach: string;
-    readonly outcome: 'succeeded' | 'failed';
+    /**
+     * `cancelled` is reserved for a host-bound explicit Memory intent. Ordinary
+     * cancelled episodes do not produce an outcome digest.
+     */
+    readonly outcome: 'succeeded' | 'failed' | 'cancelled';
     readonly summary: string;
     readonly preconditions?: string;
     readonly lesson?: string;
     readonly evidenceRefs: readonly string[];
     readonly evidence?: readonly KodaXMemoryOutcomeEvidence[];
+    /**
+     * Explicit durable intent captured from the Action LLM and bound by the
+     * host to an exact quote in the current user turn. It is evidence for the
+     * governed reviewer, never proof that Memory was queued or applied.
+     */
+    readonly memoryIntent?: KodaXMemoryIntent;
     readonly memoryInfluence?: readonly KodaXMemoryInfluenceRef[];
     readonly visibility: 'prompt_safe' | 'private' | 'sensitive';
     readonly createdAt: string;
 }
+interface KodaXMemoryIntent {
+    readonly operation: 'remember' | 'correct';
+    readonly evidenceRef: string;
+    /** Sanitized model-derived claim proposed for governed review. */
+    readonly candidateStatement: string;
+    /** Sanitized representation of the exact current-user quote verified by the host. */
+    readonly userQuote: string;
+}
 interface KodaXMemoryOutcomeEvidence {
     readonly ref: string;
     readonly grade: 'authoritative' | 'verified' | 'corroborated' | 'observed' | 'inferred';
     readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
+    readonly verdict?: 'passed' | 'failed' | 'inconclusive';
     readonly observedAt: string;
 }
 interface KodaXMemoryInfluenceRef {
@@ -115,9 +136,13 @@ interface KodaXMemoryInfluenceRef {
 interface KodaXSessionMemoryOutcomeDigestEntry extends KodaXSessionEntryBase {
     readonly type: 'memory_outcome_digest';
     readonly digest: KodaXMemoryOutcomeDigest;
+    /** Durable F263 review job identity. Absent on pre-F263 lineage records. */
+    readonly jobId?: string;
 }
 interface KodaXSessionMemoryReviewReceiptEntry extends KodaXSessionEntryBase {
     readonly type: 'memory_review_receipt';
+    /** Distinguishes repeated review keys across branch epochs. */
+    readonly jobId?: string;
     readonly reviewKey: string;
     readonly proposalIds: readonly string[];
     readonly status: 'completed' | 'no_action';
@@ -196,6 +221,8 @@ interface KodaXSessionLineage {
 }
 
 interface MemoryContextIdentity {
+    /** Explicit owner home for durable runtime state; never persisted in review envelopes. */
+    readonly configHome?: string;
     readonly tenantId: string;
     readonly workspaceId?: string;
     readonly userId?: string;
@@ -452,7 +479,15 @@ interface MemoryController {
     maybeRunAutoCurator(input?: MemoryAutoCuratorInput): Promise<MemoryAutoCuratorResult>;
     buildMemoryPack(input: MemoryPackInput): Promise<MemoryPack>;
     reviewMemoryFeedback(input: MemoryReviewInput): Promise<MemoryReviewPlan>;
+    prepareEpisodeReview?(digest: KodaXMemoryOutcomeDigest): Promise<MemoryReviewModelInput>;
+    applyReviewedEpisode?(plan: MemoryReviewPlan, digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal, revalidateAuthority?: () => Promise<void>): Promise<MemoryEpisodeReviewResult>;
     persistReviewPlan(plan: MemoryReviewPlan): Promise<readonly string[]>;
+    /**
+     * Resolves which episode-review proposals were actually auto-applied by the
+     * governed host policy. Used to keep durable receipts complete while user
+     * notices remain truthful.
+     */
+    listHostAppliedEpisodeProposalIds?(proposalIds: readonly string[]): Promise<readonly string[]>;
     reviewEpisode(digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal): Promise<MemoryEpisodeReviewResult>;
     archiveRef(id: string): Promise<MemoryLifecycleOperationResult>;
     forgetRef(id: string): Promise<MemoryLifecycleOperationResult>;
@@ -484,6 +519,7 @@ interface MemoryEvidenceRef {
     readonly ref: string;
     readonly requestedGrade: MemoryEvidenceGrade;
     readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
+    readonly verdict?: 'passed' | 'failed' | 'inconclusive';
     readonly observedAt: string;
 }
 type MemorySourcePolicy = (evidence: MemoryEvidenceRef) => MemoryEvidenceGrade;
@@ -575,7 +611,7 @@ type MemoryAgentTraceEvent = {
     /** @deprecated Retained for source compatibility; F275 no longer emits prefetch events. */
      | 'recall.prefetch.failed'
     /** @deprecated Retained for source compatibility; F275 no longer emits prefetch events. */
-     | 'recall.prefetch.discarded' | 'query.failed' | 'review.timed_out';
+     | 'recall.prefetch.discarded' | 'query.failed' | 'review.failed' | 'review.timed_out';
     readonly key: string;
     readonly detail?: string;
 } | {
@@ -585,11 +621,14 @@ type MemoryAgentTraceEvent = {
 interface MemorySessionInput {
     readonly identity: MemoryContextIdentity;
     readonly objective: string;
+    /** Stable caller-owned identity for this root episode. */
+    readonly episodeId?: string;
 }
 interface MemoryEpisodeOutcome {
     readonly status: 'succeeded' | 'failed' | 'cancelled';
     readonly summary: string;
     readonly evidence: readonly MemoryEvidenceRef[];
+    readonly memoryIntent?: KodaXMemoryIntent;
 }
 type PersistedOutcomeDigest = KodaXMemoryOutcomeDigest;
 interface MemorySession {