@atomicmemory/core 1.0.0

package/dist/schemas/response-scalars.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared scalar schemas for HTTP response validation.
+ *
+ * These preprocessors match Express serialization behavior so the development
+ * response validator can run before `JSON.stringify` converts values.
+ */
+import { z } from './zod-setup.js';
+export declare const IsoDateString: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+export declare const IsoDateStringOrNull: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>;
+export declare const NumberOrNaN: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>;

package/dist/schemas/response-scalars.js

@@ -0,0 +1,10 @@
+/**
+ * Shared scalar schemas for HTTP response validation.
+ *
+ * These preprocessors match Express serialization behavior so the development
+ * response validator can run before `JSON.stringify` converts values.
+ */
+import { z } from './zod-setup.js';
+export const IsoDateString = z.preprocess((value) => (value instanceof Date ? value.toISOString() : value), z.string());
+export const IsoDateStringOrNull = z.preprocess((value) => (value instanceof Date ? value.toISOString() : value), z.string().nullable());
+export const NumberOrNaN = z.preprocess((value) => (typeof value === 'number' && Number.isNaN(value) ? null : value), z.number().nullable());

package/dist/schemas/responses.d.ts

@@ -0,0 +1,536 @@
+/**
+ * @file Zod response schemas for every HTTP route.
+ *
+ * Mirrors the wire shapes emitted by `src/routes/memory-response-formatters.ts`
+ * and inline response literals in `src/routes/memories.ts` + `src/routes/agents.ts`.
+ * Feeds the OpenAPI registry so `npm run check:openapi` catches drift
+ * between emitted responses and the declared spec.
+ *
+ * Field naming follows the wire contract (snake_case). DB-row schemas
+ * (`MemoryRowSchema`, `LessonRowSchema`, `ClaimVersionRowSchema`,
+ * `MemoryConflictRowSchema`) declare the full column set that Express
+ * serializes — `Date` columns become ISO strings on the wire.
+ */
+import { z } from './zod-setup.js';
+export { RawDocumentResponseSchema, RegisterDocumentResponseSchema, ListDocumentsResponseSchema, DocumentListRootResponseSchema, DeleteDocumentResponseSchema, UploadRawDocumentResponseSchema, IndexDocumentResponseSchema, DocumentLimitsResponseSchema, DocumentFailureMarkerResponseSchema, } from './document-response-schemas.js';
+export declare const IngestResponseSchema: z.ZodObject<{
+    episode_id: z.ZodString;
+    facts_extracted: z.ZodNumber;
+    memories_stored: z.ZodNumber;
+    memories_updated: z.ZodNumber;
+    memories_deleted: z.ZodNumber;
+    memories_skipped: z.ZodNumber;
+    stored_memory_ids: z.ZodArray<z.ZodString>;
+    updated_memory_ids: z.ZodArray<z.ZodString>;
+    links_created: z.ZodNumber;
+    composites_created: z.ZodNumber;
+    ingest_trace_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SearchResponseSchema: z.ZodObject<{
+    count: z.ZodNumber;
+    retrieval_mode: z.ZodEnum<{
+        flat: "flat";
+        tiered: "tiered";
+        "abstract-aware": "abstract-aware";
+    }>;
+    scope: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+        user_id: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        user_id: z.ZodString;
+        workspace_id: z.ZodString;
+        agent_id: z.ZodString;
+        agent_scope: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>]>;
+    memories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        similarity: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        score: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        semantic_similarity: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        ranking_score: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        relevance: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        importance: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodNumber>>>;
+        source_site: z.ZodOptional<z.ZodString>;
+        created_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    injection_text: z.ZodOptional<z.ZodString>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    budget_constrained: z.ZodBoolean;
+    tier_assignments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        memory_id: z.ZodString;
+        tier: z.ZodString;
+        estimated_tokens: z.ZodNumber;
+    }, z.core.$strip>>>;
+    expand_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    estimated_context_tokens: z.ZodOptional<z.ZodNumber>;
+    lesson_check: z.ZodOptional<z.ZodObject<{
+        safe: z.ZodBoolean;
+        warnings: z.ZodArray<z.ZodUnknown>;
+        highest_severity: z.ZodString;
+        matched_count: z.ZodNumber;
+    }, z.core.$strip>>;
+    consensus: z.ZodOptional<z.ZodObject<{
+        original_count: z.ZodNumber;
+        filtered_count: z.ZodNumber;
+        removed_count: z.ZodNumber;
+        removed_memory_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    observability: z.ZodOptional<z.ZodObject<{
+        retrieval: z.ZodOptional<z.ZodObject<{
+            candidate_ids: z.ZodArray<z.ZodString>;
+            candidate_count: z.ZodNumber;
+            query_text: z.ZodString;
+            skip_repair: z.ZodBoolean;
+            relevance_threshold: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            relevance_filter_source: z.ZodOptional<z.ZodString>;
+            relevance_filter_reason: z.ZodOptional<z.ZodString>;
+            filtered_candidate_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            filter_decisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                source_site: z.ZodString;
+                source_kind: z.ZodEnum<{
+                    local: "local";
+                    integration: "integration";
+                }>;
+                namespace: z.ZodNullable<z.ZodString>;
+                semantic_similarity: z.ZodNumber;
+                ranking_score: z.ZodNumber;
+                relevance: z.ZodNumber;
+                threshold: z.ZodNullable<z.ZodNumber>;
+                decision: z.ZodEnum<{
+                    filtered: "filtered";
+                    kept: "kept";
+                }>;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
+            trace_id: z.ZodOptional<z.ZodString>;
+            stage_count: z.ZodOptional<z.ZodNumber>;
+            stage_names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        packaging: z.ZodOptional<z.ZodObject<{
+            package_type: z.ZodEnum<{
+                tiered: "tiered";
+                "subject-pack": "subject-pack";
+                "timeline-pack": "timeline-pack";
+            }>;
+            included_ids: z.ZodArray<z.ZodString>;
+            dropped_ids: z.ZodArray<z.ZodString>;
+            evidence_roles: z.ZodRecord<z.ZodString, z.ZodEnum<{
+                primary: "primary";
+                supporting: "supporting";
+                historical: "historical";
+                contextual: "contextual";
+            }>>;
+            episode_count: z.ZodNumber;
+            date_count: z.ZodNumber;
+            has_current_marker: z.ZodBoolean;
+            has_conflict_block: z.ZodBoolean;
+            token_cost: z.ZodNumber;
+        }, z.core.$strip>>;
+        assembly: z.ZodOptional<z.ZodObject<{
+            final_ids: z.ZodArray<z.ZodString>;
+            final_token_cost: z.ZodNumber;
+            token_budget: z.ZodNullable<z.ZodNumber>;
+            primary_evidence_position: z.ZodNullable<z.ZodNumber>;
+            blocks: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    specialist_answer: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ExpandResponseSchema: z.ZodObject<{
+    memories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        content: z.ZodString;
+        embedding: z.ZodArray<z.ZodNumber>;
+        memory_type: z.ZodString;
+        importance: z.ZodNumber;
+        source_site: z.ZodString;
+        source_url: z.ZodString;
+        episode_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodEnum<{
+            active: "active";
+            needs_clarification: "needs_clarification";
+        }>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        keywords: z.ZodString;
+        namespace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        summary: z.ZodString;
+        overview: z.ZodString;
+        trust_score: z.ZodNumber;
+        observed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        last_accessed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        access_count: z.ZodNumber;
+        expired_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+        deleted_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+        network: z.ZodUnknown;
+        opinion_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        observation_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        visibility: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            agent_only: "agent_only";
+            restricted: "restricted";
+            workspace: "workspace";
+        }>>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export declare const VerifyResponseSchema: z.ZodObject<{
+    verified_answer: z.ZodString;
+    changed: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const ListResponseSchema: z.ZodObject<{
+    memories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        content: z.ZodString;
+        embedding: z.ZodArray<z.ZodNumber>;
+        memory_type: z.ZodString;
+        importance: z.ZodNumber;
+        source_site: z.ZodString;
+        source_url: z.ZodString;
+        episode_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodEnum<{
+            active: "active";
+            needs_clarification: "needs_clarification";
+        }>;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        keywords: z.ZodString;
+        namespace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        summary: z.ZodString;
+        overview: z.ZodString;
+        trust_score: z.ZodNumber;
+        observed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        last_accessed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        access_count: z.ZodNumber;
+        expired_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+        deleted_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+        network: z.ZodUnknown;
+        opinion_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        observation_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        workspace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        visibility: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            agent_only: "agent_only";
+            restricted: "restricted";
+            workspace: "workspace";
+        }>>>;
+    }, z.core.$loose>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const GetMemoryResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    user_id: z.ZodString;
+    content: z.ZodString;
+    embedding: z.ZodArray<z.ZodNumber>;
+    memory_type: z.ZodString;
+    importance: z.ZodNumber;
+    source_site: z.ZodString;
+    source_url: z.ZodString;
+    episode_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodEnum<{
+        active: "active";
+        needs_clarification: "needs_clarification";
+    }>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    keywords: z.ZodString;
+    namespace: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodString;
+    overview: z.ZodString;
+    trust_score: z.ZodNumber;
+    observed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    last_accessed_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    access_count: z.ZodNumber;
+    expired_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+    deleted_at: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+    network: z.ZodUnknown;
+    opinion_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    observation_subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    workspace_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    agent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visibility: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        agent_only: "agent_only";
+        restricted: "restricted";
+        workspace: "workspace";
+    }>>>;
+}, z.core.$loose>;
+export declare const StatsResponseSchema: z.ZodObject<{
+    count: z.ZodNumber;
+    avg_importance: z.ZodNumber;
+    source_distribution: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export declare const HealthResponseSchema: z.ZodObject<{
+    status: z.ZodLiteral<"ok">;
+    config: z.ZodObject<{
+        retrieval_profile: z.ZodString;
+        embedding_provider: z.ZodString;
+        embedding_model: z.ZodString;
+        voyage_document_model: z.ZodString;
+        voyage_query_model: z.ZodString;
+        llm_provider: z.ZodString;
+        llm_model: z.ZodString;
+        clarification_conflict_threshold: z.ZodNumber;
+        max_search_results: z.ZodNumber;
+        hybrid_search_enabled: z.ZodBoolean;
+        iterative_retrieval_enabled: z.ZodBoolean;
+        entity_graph_enabled: z.ZodBoolean;
+        cross_encoder_enabled: z.ZodBoolean;
+        agentic_retrieval_enabled: z.ZodBoolean;
+        repair_loop_enabled: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const ConfigUpdateResponseSchema: z.ZodObject<{
+    applied: z.ZodArray<z.ZodString>;
+    config: z.ZodObject<{
+        retrieval_profile: z.ZodString;
+        embedding_provider: z.ZodString;
+        embedding_model: z.ZodString;
+        voyage_document_model: z.ZodString;
+        voyage_query_model: z.ZodString;
+        llm_provider: z.ZodString;
+        llm_model: z.ZodString;
+        clarification_conflict_threshold: z.ZodNumber;
+        max_search_results: z.ZodNumber;
+        hybrid_search_enabled: z.ZodBoolean;
+        iterative_retrieval_enabled: z.ZodBoolean;
+        entity_graph_enabled: z.ZodBoolean;
+        cross_encoder_enabled: z.ZodBoolean;
+        agentic_retrieval_enabled: z.ZodBoolean;
+        repair_loop_enabled: z.ZodBoolean;
+    }, z.core.$strip>;
+    note: z.ZodString;
+}, z.core.$strip>;
+export declare const ConsolidateResponseSchema: z.ZodUnion<readonly [z.ZodObject<{
+    memories_scanned: z.ZodNumber;
+    clusters_found: z.ZodNumber;
+    memories_in_clusters: z.ZodNumber;
+    clusters: z.ZodArray<z.ZodObject<{
+        member_ids: z.ZodArray<z.ZodString>;
+        member_contents: z.ZodArray<z.ZodString>;
+        avg_affinity: z.ZodNumber;
+        member_count: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    clusters_consolidated: z.ZodNumber;
+    memories_archived: z.ZodNumber;
+    memories_created: z.ZodNumber;
+    consolidated_memory_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>]>;
+export declare const FirstMentionsExtractResponseSchema: z.ZodObject<{
+    events: z.ZodArray<z.ZodObject<{
+        topic: z.ZodString;
+        turn_id: z.ZodNumber;
+        memory_id: z.ZodString;
+        anchor_date: z.ZodNullable<z.ZodString>;
+        position_in_conversation: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const EventChainsResponseSchema: z.ZodObject<{
+    chains: z.ZodArray<z.ZodObject<{
+        entity_id: z.ZodString;
+        events: z.ZodArray<z.ZodObject<{
+            memory_id: z.ZodString;
+            content: z.ZodString;
+            observation_date: z.ZodString;
+            position_in_chain: z.ZodNumber;
+            predecessor_memory_id: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const DecayResponseSchema: z.ZodObject<{
+    memories_evaluated: z.ZodNumber;
+    candidates_for_archival: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        content: z.ZodString;
+        retention_score: z.ZodNumber;
+        importance: z.ZodNumber;
+        days_since_access: z.ZodNumber;
+        access_count: z.ZodNumber;
+    }, z.core.$strip>>;
+    retention_threshold: z.ZodNumber;
+    avg_retention_score: z.ZodNumber;
+    archived: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CapResponseSchema: z.ZodObject<{
+    active_memories: z.ZodNumber;
+    max_memories: z.ZodNumber;
+    status: z.ZodEnum<{
+        warn: "warn";
+        ok: "ok";
+        exceeded: "exceeded";
+    }>;
+    usage_ratio: z.ZodNumber;
+    recommendation: z.ZodEnum<{
+        none: "none";
+        consolidate: "consolidate";
+        decay: "decay";
+        "consolidate-and-decay": "consolidate-and-decay";
+    }>;
+}, z.core.$strip>;
+export declare const LessonsListResponseSchema: z.ZodObject<{
+    lessons: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        lesson_type: z.ZodEnum<{
+            injection_blocked: "injection_blocked";
+            false_memory: "false_memory";
+            contradiction_pattern: "contradiction_pattern";
+            user_reported: "user_reported";
+            consensus_violation: "consensus_violation";
+            trust_violation: "trust_violation";
+        }>;
+        pattern: z.ZodString;
+        embedding: z.ZodArray<z.ZodNumber>;
+        source_memory_ids: z.ZodArray<z.ZodString>;
+        source_query: z.ZodNullable<z.ZodString>;
+        severity: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            critical: "critical";
+        }>;
+        active: z.ZodBoolean;
+        metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    }, z.core.$loose>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LessonStatsResponseSchema: z.ZodObject<{
+    total_active: z.ZodNumber;
+    by_type: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export declare const LessonReportResponseSchema: z.ZodObject<{
+    lesson_id: z.ZodString;
+}, z.core.$strip>;
+export declare const ReconciliationResponseSchema: z.ZodObject<{
+    processed: z.ZodNumber;
+    resolved: z.ZodNumber;
+    noops: z.ZodNumber;
+    updates: z.ZodNumber;
+    supersedes: z.ZodNumber;
+    deletes: z.ZodNumber;
+    adds: z.ZodNumber;
+    errors: z.ZodNumber;
+    duration_ms: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ReconcileStatusResponseSchema: z.ZodObject<{
+    pending: z.ZodNumber;
+    enabled: z.ZodBoolean;
+}, z.core.$loose>;
+export declare const ResetSourceResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+    deleted_memories: z.ZodNumber;
+    deleted_episodes: z.ZodNumber;
+    deleted_documents: z.ZodNumber;
+}, z.core.$strip>;
+export declare const SuccessResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export declare const MutationSummaryResponseSchema: z.ZodObject<{
+    total_versions: z.ZodNumber;
+    active_versions: z.ZodNumber;
+    superseded_versions: z.ZodNumber;
+    total_claims: z.ZodNumber;
+    by_mutation_type: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export declare const AuditRecentResponseSchema: z.ZodObject<{
+    mutations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        claim_id: z.ZodString;
+        user_id: z.ZodString;
+        memory_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodString;
+        embedding: z.ZodArray<z.ZodNumber>;
+        importance: z.ZodNumber;
+        source_site: z.ZodString;
+        source_url: z.ZodString;
+        episode_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        valid_from: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        valid_to: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>>;
+        superseded_by_version_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        mutation_type: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            add: "add";
+            update: "update";
+            supersede: "supersede";
+            delete: "delete";
+            clarify: "clarify";
+        }>>>;
+        mutation_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        previous_version_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        actor_model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        contradiction_confidence: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+    }, z.core.$loose>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AuditTrailResponseSchema: z.ZodObject<{
+    memory_id: z.ZodString;
+    trail: z.ZodArray<z.ZodObject<{
+        version_id: z.ZodString;
+        claim_id: z.ZodString;
+        content: z.ZodString;
+        mutation_type: z.ZodNullable<z.ZodEnum<{
+            add: "add";
+            update: "update";
+            supersede: "supersede";
+            delete: "delete";
+            clarify: "clarify";
+        }>>;
+        mutation_reason: z.ZodNullable<z.ZodString>;
+        actor_model: z.ZodNullable<z.ZodString>;
+        contradiction_confidence: z.ZodNullable<z.ZodNumber>;
+        previous_version_id: z.ZodNullable<z.ZodString>;
+        superseded_by_version_id: z.ZodNullable<z.ZodString>;
+        valid_from: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        valid_to: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>;
+        memory_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    version_count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const TrustResponseSchema: z.ZodObject<{
+    agent_id: z.ZodString;
+    trust_level: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ConflictsListResponseSchema: z.ZodObject<{
+    conflicts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        new_memory_id: z.ZodNullable<z.ZodString>;
+        existing_memory_id: z.ZodNullable<z.ZodString>;
+        new_agent_id: z.ZodNullable<z.ZodString>;
+        existing_agent_id: z.ZodNullable<z.ZodString>;
+        new_trust_level: z.ZodNullable<z.ZodNumber>;
+        existing_trust_level: z.ZodNullable<z.ZodNumber>;
+        contradiction_confidence: z.ZodNumber;
+        clarification_note: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            resolved_new: "resolved_new";
+            resolved_existing: "resolved_existing";
+            resolved_both: "resolved_both";
+            open: "open";
+            auto_resolved: "auto_resolved";
+        }>;
+        resolution_policy: z.ZodNullable<z.ZodString>;
+        resolved_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>;
+        created_at: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
+        auto_resolve_after: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export declare const ResolveConflictResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        resolved_new: "resolved_new";
+        resolved_existing: "resolved_existing";
+        resolved_both: "resolved_both";
+    }>;
+}, z.core.$strip>;
+export declare const AutoResolveConflictsResponseSchema: z.ZodObject<{
+    resolved: z.ZodNumber;
+}, z.core.$strip>;