@ghostpaw/affinity 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -17,6 +17,7 @@ declare abstract class AffinityError extends Error {
 
 /** Uniqueness, routing, or ownership collision. */
 declare class AffinityConflictError extends AffinityError {
+    existingContactId?: number;
     readonly code: "CONFLICT";
 }
 
@@ -137,6 +138,7 @@ interface AttributeEntry {
 
 /** Attribute row for mutation receipts — stable id + target + payload. */
 interface AttributeRecord {
+    eventId?: number;
     id: number;
     contactId: number | null;
     linkId: number | null;
@@ -145,7 +147,7 @@ interface AttributeRecord {
 }
 
 /**
- * Write target for attributes — exactly one of contact or link (CONCEPT.md).
+ * Write target for attributes — exactly one of contact, link or event (CONCEPT.md).
  */
 type AttributeTarget = {
     kind: "contact";
@@ -153,6 +155,9 @@ type AttributeTarget = {
 } | {
     kind: "link";
     id: number;
+} | {
+    kind: "event";
+    eventId: number;
 };
 
 /** Open commitment lifecycle on reads — CONCEPT.md CommitmentRecord. */
@@ -167,11 +172,14 @@ interface EventParticipantView {
 
 /** Promise/agreement projection — CONCEPT.md CommitmentRecord. */
 interface CommitmentRecord {
+    dueAtIso?: string | null;
+    overdue?: boolean;
     eventId: number;
     type: EventType;
     summary: string;
     participants: readonly EventParticipantView[];
     dueAt?: number | null;
+    dueOn?: string | null;
     resolutionState: CommitmentResolutionState;
 }
 
@@ -193,6 +201,7 @@ declare const AFFINITY_DEFAULT_LIST_LIMIT = 50;
 declare const AFFINITY_MAX_LIST_LIMIT = 250;
 /** Shared list-style read controls — CONCEPT.md Global query contract. */
 interface AffinityListReadOptions {
+    now?: number;
     limit?: number;
     offset?: number;
     sort?: string;
@@ -206,17 +215,22 @@ interface AffinityListReadOptions {
 
 /** Options for `read.getContactJournal` / `read.getLinkTimeline`. */
 type ContactJournalReadOptions = AffinityListReadOptions & {
+    includeContent?: boolean;
+    channel?: string;
     eventTypes?: readonly EventType[];
 };
 
 /** Options for `read.getContactProfile`. */
 interface ContactProfileReadOptions {
     /** Cap on relational links returned in `topLinks` (default 8). */
+    recentEventsLimit?: number;
+    now?: number;
     topLinksLimit?: number;
 }
 
 /** Compact portfolio row — CONCEPT.md ContactListItem. */
 interface ContactListItem {
+    matchedOn?: string[];
     id: number;
     name: string;
     kind: ContactKind;
@@ -226,6 +240,63 @@ interface ContactListItem {
     lastMeaningfulEventAt?: number | null;
 }
 
+/** Shared participant row for evidence writes — CONCEPT.md SocialEventInput. */
+interface SocialEventParticipantInput {
+    contactId: number;
+    role: EventParticipantRole;
+    directionality?: undefined | "owner_initiated" | "other_initiated" | "mutual" | "observed";
+}
+/** Evidence intake shape shared by interaction-style writes — CONCEPT.md. */
+interface SocialEventInput {
+    occurredAt: number;
+    occurredOn?: string;
+    summary?: string;
+    content?: string;
+    affectsBond?: boolean;
+    externalRef?: ExternalRef;
+    channel?: string;
+    parentRef?: ExternalRef;
+    parentEventId?: number;
+    threadRef?: ExternalRef;
+    momentKind?: EventMomentKind;
+    /** Significance 1..10 — enforced at write layer. */
+    significance: number;
+    participants: readonly SocialEventParticipantInput[];
+    provenance?: unknown;
+}
+/** Stable external event identity. */
+interface ExternalRef {
+    source: string;
+    id: string;
+}
+
+/** Journal entry with explicit participants — CONCEPT.md EventRecord. */
+interface EventRecord {
+    content?: string;
+    externalRef?: ExternalRef;
+    channel?: string;
+    parentRef?: ExternalRef;
+    parentEventId?: number;
+    threadRef?: ExternalRef;
+    attributes?: AttributeRecord[];
+    id: number;
+    affectsBond?: boolean;
+    type: EventType;
+    occurredAt: number;
+    occurredOn?: string;
+    dueAt?: number | null;
+    dueOn?: string | null;
+    summary: string;
+    significance: number;
+    momentKind: EventMomentKind | null;
+    participants: readonly EventParticipantView[];
+    recurrenceKind?: EventRecurrenceKind | null;
+    anchorMonth?: number | null;
+    anchorDay?: number | null;
+    anchorContactId?: number | null;
+    anchorLinkId?: number | null;
+}
+
 /** One routing identity on a contact — CONCEPT.md IdentityRecord. */
 interface IdentityRecord {
     id: number;
@@ -241,6 +312,7 @@ interface IdentityRecord {
 /** Compact link row for lists — CONCEPT.md LinkListItem. */
 interface LinkListItem {
     id: number;
+    counterpartyName?: string;
     fromContactId: number;
     toContactId: number;
     kind: LinkKind;
@@ -289,6 +361,8 @@ interface UpcomingDateRecord {
     recurrenceKind: EventRecurrenceKind;
     /** Epoch milliseconds for the materialized next occurrence (sorting key). */
     occursOn: number;
+    /** Calendar date; occursOn retains its existing numeric sorting key. */
+    occursOnDate?: string;
     summary: string;
     significance: number;
 }
@@ -296,6 +370,21 @@ interface UpcomingDateRecord {
 /** Full contact detail — CONCEPT.md ContactProfileRecord. */
 interface ContactProfileRecord {
     contact: ContactCore;
+    recentEvents?: readonly (EventRecord & {
+        occurredAtIso: string;
+    })[];
+    openCommitments?: readonly CommitmentRecord[];
+    ties?: readonly {
+        id: number;
+        kind: string;
+        role: string | null;
+        contactId: number;
+        name: string;
+    }[];
+    mergedInto?: {
+        id: number;
+        name: string;
+    };
     identities: readonly IdentityRecord[];
     attributes: readonly AttributeEntry[];
     topLinks: readonly LinkListItem[];
@@ -339,6 +428,7 @@ interface AddDateAnchorInput {
 
 /** Arguments for `write.addIdentity`. */
 interface AddIdentityInput {
+    ifExists?: "error" | "return";
     type: string;
     value: string;
     label?: string | null;
@@ -352,6 +442,8 @@ interface CreateContactInput {
     name: string;
     kind: ContactKind;
     now?: number;
+    identities?: AddIdentityInput[];
+    ifExists?: "error" | "return";
     /**
      * When true, marks this row as the sole owner contact.
      * Allowed only while no other live owner exists.
@@ -401,26 +493,11 @@ interface SetStructuralTieInput {
     now?: number;
 }
 
-/** Shared participant row for evidence writes — CONCEPT.md SocialEventInput. */
-interface SocialEventParticipantInput {
-    contactId: number;
-    role: EventParticipantRole;
-    directionality?: "owner_initiated" | "other_initiated" | "mutual" | "observed";
-}
-/** Evidence intake shape shared by interaction-style writes — CONCEPT.md. */
-interface SocialEventInput {
-    occurredAt: number;
-    summary: string;
-    /** Significance 1..10 — enforced at write layer. */
-    significance: number;
-    participants: readonly SocialEventParticipantInput[];
-    provenance?: unknown;
-}
-
 /** Arguments for `write.recordCommitment`. */
 interface RecordCommitmentInput extends SocialEventInput {
     commitmentType: "promise" | "agreement";
     dueAt?: number | null;
+    dueOn?: string | null;
     now?: number;
 }
 
@@ -450,6 +527,7 @@ interface RecordTransactionInput extends SocialEventInput {
 interface ResolveCommitmentEventInput {
     type?: Exclude<EventType, "date_anchor">;
     occurredAt?: number;
+    occurredOn?: string;
     summary?: string;
     significance?: number;
     participants?: readonly SocialEventParticipantInput[];
@@ -479,6 +557,7 @@ interface ReviseDateAnchorOptions {
 
 /** Arguments for `write.seedSocialLink`. */
 interface SeedSocialLinkInput {
+    ifExists?: "error" | "return";
     fromContactId: number;
     toContactId: number;
     kind: RelationalLinkKind;
@@ -550,27 +629,24 @@ interface DismissedDuplicateRecord {
     dismissedAt: number;
 }
 
-/** Journal entry with explicit participants — CONCEPT.md EventRecord. */
-interface EventRecord {
-    id: number;
-    type: EventType;
-    occurredAt: number;
-    summary: string;
-    significance: number;
-    momentKind: EventMomentKind | null;
-    participants: readonly EventParticipantView[];
-    recurrenceKind?: EventRecurrenceKind | null;
-    anchorMonth?: number | null;
-    anchorDay?: number | null;
-    anchorContactId?: number | null;
-    anchorLinkId?: number | null;
-}
-
 /** Raw `events` row from SQLite (snake_case columns). */
 interface EventRow {
+    content?: string | null;
+    external_source?: string | null;
+    external_id?: string | null;
+    channel?: string | null;
+    parent_source?: string | null;
+    parent_ref_id?: string | null;
+    parent_event_id?: number | null;
+    thread_source?: string | null;
+    thread_id?: string | null;
+    provenance_json?: string | null;
     id: number;
     type: string;
     occurred_at: number;
+    occurred_on?: string | null;
+    due_at?: number | null;
+    due_on?: string | null;
     summary: string;
     significance: number;
     moment_kind: string | null;
@@ -590,6 +666,7 @@ interface MomentRecord {
     linkId: number;
     momentKind: EventMomentKind;
     occurredAt: number;
+    occurredOn?: string;
     summary: string;
     impactScore: number;
 }
@@ -612,6 +689,7 @@ interface LinkDetailReadOptions {
 
 /** Common filters for link list reads — CONCEPT.md. */
 interface LinkListReadFilters {
+    includeLost?: boolean;
     kind?: LinkKind;
     state?: LinkState;
 }
@@ -643,6 +721,9 @@ interface LinkRow {
 
 /** Filters for `read.listContacts` — CONCEPT.md portfolio list. */
 interface ListContactsFilters {
+    attribute?: string | string[];
+    tag?: string | string[];
+    includeLost?: boolean;
     kind?: ContactKind;
     lifecycleState?: ContactLifecycleState;
     includeOwner?: boolean;
@@ -700,6 +781,10 @@ interface MergePrimary {
  */
 interface MutationReceipt<TPrimary> {
     primary: TPrimary;
+    warnings?: {
+        code: "future_event";
+        message: string;
+    }[];
     created: EntityRef[];
     updated: EntityRef[];
     archived: EntityRef[];
@@ -707,16 +792,22 @@ interface MutationReceipt<TPrimary> {
     affectedLinks: number[];
     derivedEffects: DerivedLinkEffect[];
 }
-type ContactMutationReceipt = MutationReceipt<ContactListItem>;
+type ContactMutationReceipt = MutationReceipt<ContactListItem> & {
+    outcome?: "success" | "no_op";
+    matchedIdentities?: AddIdentityInput[];
+};
 type IdentityMutationReceipt = MutationReceipt<IdentityRecord>;
 type LinkMutationReceipt = MutationReceipt<LinkListItem>;
-type EventMutationReceipt = MutationReceipt<EventRecord>;
+type EventMutationReceipt = MutationReceipt<EventRecord> & {
+    outcome?: "success" | "no_op";
+};
 type AttributeMutationReceipt = MutationReceipt<AttributeRecord>;
 type MergeReceipt = MutationReceipt<MergePrimary>;
 type DismissalMutationReceipt = MutationReceipt<DismissedPairRef>;
 
 /** Maintenance radar row — CONCEPT.md RadarRecord. */
 interface RadarRecord {
+    reasons?: string[];
     linkId: number;
     contactId: number;
     driftPriority: number;
@@ -740,6 +831,67 @@ interface MergeHistoryRecord {
     manual: boolean;
 }
 
+interface EventSearchItem {
+    [key: string]: unknown;
+    kind: "event";
+    id: number;
+    occurredOn: string;
+    type: string;
+    title: string;
+    matchedOn: string[];
+    externalRef?: ExternalRef;
+}
+declare function searchEvents(db: AffinityDb, query: string, options?: {
+    limit?: number;
+    offset?: number;
+}): EventSearchItem[];
+declare function getEventThread(db: AffinityDb, source: string, id: string, options?: {
+    includeContent?: boolean;
+    channel?: string;
+    limit?: number;
+    offset?: number;
+}): EventRecord[];
+
+declare function getContactJournal(db: AffinityDb, contactId: number, options?: ContactJournalReadOptions): EventRecord[];
+
+declare function listMoments(db: AffinityDb, filters?: ListMomentsFilters, options?: AffinityListReadOptions & {
+    channel?: string;
+}): MomentRecord[];
+
+declare function listOpenCommitments(db: AffinityDb, filters?: ListOpenCommitmentsFilters, options?: AffinityListReadOptions & {
+    channel?: string;
+}): CommitmentRecord[];
+
+declare function recordCommitment(db: AffinityDb, input: RecordCommitmentInput): EventMutationReceipt;
+
+declare function recordInteraction(db: AffinityDb, input: RecordInteractionInput): EventMutationReceipt;
+
+declare function recordMilestone(db: AffinityDb, input: RecordMilestoneInput): EventMutationReceipt;
+
+declare function recordObservation(db: AffinityDb, input: RecordObservationInput): EventMutationReceipt;
+
+declare function recordTransaction(db: AffinityDb, input: RecordTransactionInput): EventMutationReceipt;
+
+declare function resolveCommitment(db: AffinityDb, commitmentEventId: number, resolution: CommitmentResolutionKind, options?: ResolveCommitmentOptions): EventMutationReceipt;
+
+type EventTarget = number | {
+    eventId?: number;
+    ref?: ExternalRef;
+};
+interface ReviseEventPatch {
+    summary?: string;
+    content?: string;
+    occurredAt?: number;
+    significance?: number;
+    channel?: string;
+    type?: EventType;
+    externalRef?: ExternalRef;
+}
+declare function reviseEvent(db: AffinityDb, target: EventTarget, patch: ReviseEventPatch): EventMutationReceipt;
+declare function deleteEvent(db: AffinityDb, target: EventTarget, options: {
+    confirm: boolean;
+}): EventMutationReceipt;
+
 declare const types_AFFINITY_DEFAULT_LIST_LIMIT: typeof AFFINITY_DEFAULT_LIST_LIMIT;
 declare const types_AFFINITY_MAX_LIST_LIMIT: typeof AFFINITY_MAX_LIST_LIMIT;
 type types_AddDateAnchorInput = AddDateAnchorInput;
@@ -781,7 +933,10 @@ type types_EventParticipantView = EventParticipantView;
 type types_EventRecord = EventRecord;
 type types_EventRecurrenceKind = EventRecurrenceKind;
 type types_EventRow = EventRow;
+type types_EventSearchItem = EventSearchItem;
+type types_EventTarget = EventTarget;
 type types_EventType = EventType;
+type types_ExternalRef = ExternalRef;
 type types_IdentityMutationReceipt = IdentityMutationReceipt;
 type types_IdentityRecord = IdentityRecord;
 type types_IdentityRow = IdentityRow;
@@ -820,6 +975,7 @@ type types_ResolveCommitmentOptions = ResolveCommitmentOptions;
 type types_ReviseContactPatch = ReviseContactPatch;
 type types_ReviseDateAnchorOptions = ReviseDateAnchorOptions;
 type types_ReviseDateAnchorPatch = ReviseDateAnchorPatch;
+type types_ReviseEventPatch = ReviseEventPatch;
 type types_ReviseIdentityPatch = ReviseIdentityPatch;
 type types_SeedSocialLinkInput = SeedSocialLinkInput;
 type types_SetContactLifecycleOptions = SetContactLifecycleOptions;
@@ -831,7 +987,7 @@ type types_UpcomingDateRecord = UpcomingDateRecord;
 type types_UpcomingDateTargetRef = UpcomingDateTargetRef;
 declare const types_resolveAffinityListLimit: typeof resolveAffinityListLimit;
 declare namespace types {
-  export { types_AFFINITY_DEFAULT_LIST_LIMIT as AFFINITY_DEFAULT_LIST_LIMIT, types_AFFINITY_MAX_LIST_LIMIT as AFFINITY_MAX_LIST_LIMIT, type types_AddDateAnchorInput as AddDateAnchorInput, type types_AddIdentityInput as AddIdentityInput, type types_AffinityChartEdge as AffinityChartEdge, type types_AffinityChartNode as AffinityChartNode, type types_AffinityChartReadOptions as AffinityChartReadOptions, type types_AffinityChartRecord as AffinityChartRecord, type types_AffinityListReadOptions as AffinityListReadOptions, type types_AttributeEntry as AttributeEntry, type types_AttributeMutationReceipt as AttributeMutationReceipt, type types_AttributeName as AttributeName, type types_AttributeRecord as AttributeRecord, type types_AttributeTarget as AttributeTarget, type types_CommitmentRecord as CommitmentRecord, type types_CommitmentResolutionKind as CommitmentResolutionKind, type types_CommitmentResolutionState as CommitmentResolutionState, type types_ContactCore as ContactCore, type types_ContactJournalReadOptions as ContactJournalReadOptions, type types_ContactKind as ContactKind, type types_ContactLifecycleState as ContactLifecycleState, type types_ContactListItem as ContactListItem, type types_ContactMutationReceipt as ContactMutationReceipt, type types_ContactProfileReadOptions as ContactProfileReadOptions, type types_ContactProfileRecord as ContactProfileRecord, type types_ContactRow as ContactRow, type types_CreateContactInput as CreateContactInput, type types_DateAnchorTarget as DateAnchorTarget, type types_DerivedLinkEffect as DerivedLinkEffect, type types_DismissalMutationReceipt as DismissalMutationReceipt, type types_DismissedDuplicateRecord as DismissedDuplicateRecord, type types_DismissedPairRef as DismissedPairRef, type types_DuplicateCandidateRecord as DuplicateCandidateRecord, type types_EntityRef as EntityRef, type types_EventMomentKind as EventMomentKind, type types_EventMutationReceipt as EventMutationReceipt, type types_EventParticipantRole as EventParticipantRole, type types_EventParticipantView as EventParticipantView, type types_EventRecord as EventRecord, type types_EventRecurrenceKind as EventRecurrenceKind, type types_EventRow as EventRow, type types_EventType as EventType, type types_IdentityMutationReceipt as IdentityMutationReceipt, type types_IdentityRecord as IdentityRecord, type types_IdentityRow as IdentityRow, type types_IdentityType as IdentityType, type types_InteractionEventType as InteractionEventType, type types_LinkDetailReadOptions as LinkDetailReadOptions, type types_LinkDetailRecord as LinkDetailRecord, type types_LinkKind as LinkKind, type types_LinkListItem as LinkListItem, type types_LinkListReadFilters as LinkListReadFilters, type types_LinkMutationOptions as LinkMutationOptions, type types_LinkMutationReceipt as LinkMutationReceipt, type types_LinkRow as LinkRow, type types_LinkState as LinkState, type types_ListContactsFilters as ListContactsFilters, type types_ListDuplicateCandidatesFilters as ListDuplicateCandidatesFilters, type types_ListMomentsFilters as ListMomentsFilters, type types_ListOpenCommitmentsFilters as ListOpenCommitmentsFilters, type types_ListUpcomingDatesFilters as ListUpcomingDatesFilters, type types_MergeContactsInput as MergeContactsInput, type types_MergeHistoryRecord as MergeHistoryRecord, type types_MergePrimary as MergePrimary, type types_MergeReceipt as MergeReceipt, type types_MomentRecord as MomentRecord, type types_MutationReceipt as MutationReceipt, type types_OpaqueDerivation as OpaqueDerivation, type types_OpaqueRollup as OpaqueRollup, type types_RadarRecord as RadarRecord, type types_RecordCommitmentInput as RecordCommitmentInput, type types_RecordInteractionInput as RecordInteractionInput, type types_RecordMilestoneInput as RecordMilestoneInput, type types_RecordObservationInput as RecordObservationInput, type types_RecordTransactionInput as RecordTransactionInput, type types_RelationalLinkKind as RelationalLinkKind, type types_ResolveCommitmentOptions as ResolveCommitmentOptions, type types_ReviseContactPatch as ReviseContactPatch, type types_ReviseDateAnchorOptions as ReviseDateAnchorOptions, type types_ReviseDateAnchorPatch as ReviseDateAnchorPatch, type types_ReviseIdentityPatch as ReviseIdentityPatch, type types_SeedSocialLinkInput as SeedSocialLinkInput, type types_SetContactLifecycleOptions as SetContactLifecycleOptions, type types_SetStructuralTieInput as SetStructuralTieInput, type types_SocialEventInput as SocialEventInput, type types_SocialEventParticipantInput as SocialEventParticipantInput, type types_StructuralLinkKind as StructuralLinkKind, type types_UpcomingDateRecord as UpcomingDateRecord, type types_UpcomingDateTargetRef as UpcomingDateTargetRef, types_resolveAffinityListLimit as resolveAffinityListLimit };
+  export { types_AFFINITY_DEFAULT_LIST_LIMIT as AFFINITY_DEFAULT_LIST_LIMIT, types_AFFINITY_MAX_LIST_LIMIT as AFFINITY_MAX_LIST_LIMIT, type types_AddDateAnchorInput as AddDateAnchorInput, type types_AddIdentityInput as AddIdentityInput, type types_AffinityChartEdge as AffinityChartEdge, type types_AffinityChartNode as AffinityChartNode, type types_AffinityChartReadOptions as AffinityChartReadOptions, type types_AffinityChartRecord as AffinityChartRecord, type types_AffinityListReadOptions as AffinityListReadOptions, type types_AttributeEntry as AttributeEntry, type types_AttributeMutationReceipt as AttributeMutationReceipt, type types_AttributeName as AttributeName, type types_AttributeRecord as AttributeRecord, type types_AttributeTarget as AttributeTarget, type types_CommitmentRecord as CommitmentRecord, type types_CommitmentResolutionKind as CommitmentResolutionKind, type types_CommitmentResolutionState as CommitmentResolutionState, type types_ContactCore as ContactCore, type types_ContactJournalReadOptions as ContactJournalReadOptions, type types_ContactKind as ContactKind, type types_ContactLifecycleState as ContactLifecycleState, type types_ContactListItem as ContactListItem, type types_ContactMutationReceipt as ContactMutationReceipt, type types_ContactProfileReadOptions as ContactProfileReadOptions, type types_ContactProfileRecord as ContactProfileRecord, type types_ContactRow as ContactRow, type types_CreateContactInput as CreateContactInput, type types_DateAnchorTarget as DateAnchorTarget, type types_DerivedLinkEffect as DerivedLinkEffect, type types_DismissalMutationReceipt as DismissalMutationReceipt, type types_DismissedDuplicateRecord as DismissedDuplicateRecord, type types_DismissedPairRef as DismissedPairRef, type types_DuplicateCandidateRecord as DuplicateCandidateRecord, type types_EntityRef as EntityRef, type types_EventMomentKind as EventMomentKind, type types_EventMutationReceipt as EventMutationReceipt, type types_EventParticipantRole as EventParticipantRole, type types_EventParticipantView as EventParticipantView, type types_EventRecord as EventRecord, type types_EventRecurrenceKind as EventRecurrenceKind, type types_EventRow as EventRow, type types_EventSearchItem as EventSearchItem, type types_EventTarget as EventTarget, type types_EventType as EventType, type types_ExternalRef as ExternalRef, type types_IdentityMutationReceipt as IdentityMutationReceipt, type types_IdentityRecord as IdentityRecord, type types_IdentityRow as IdentityRow, type types_IdentityType as IdentityType, type types_InteractionEventType as InteractionEventType, type types_LinkDetailReadOptions as LinkDetailReadOptions, type types_LinkDetailRecord as LinkDetailRecord, type types_LinkKind as LinkKind, type types_LinkListItem as LinkListItem, type types_LinkListReadFilters as LinkListReadFilters, type types_LinkMutationOptions as LinkMutationOptions, type types_LinkMutationReceipt as LinkMutationReceipt, type types_LinkRow as LinkRow, type types_LinkState as LinkState, type types_ListContactsFilters as ListContactsFilters, type types_ListDuplicateCandidatesFilters as ListDuplicateCandidatesFilters, type types_ListMomentsFilters as ListMomentsFilters, type types_ListOpenCommitmentsFilters as ListOpenCommitmentsFilters, type types_ListUpcomingDatesFilters as ListUpcomingDatesFilters, type types_MergeContactsInput as MergeContactsInput, type types_MergeHistoryRecord as MergeHistoryRecord, type types_MergePrimary as MergePrimary, type types_MergeReceipt as MergeReceipt, type types_MomentRecord as MomentRecord, type types_MutationReceipt as MutationReceipt, type types_OpaqueDerivation as OpaqueDerivation, type types_OpaqueRollup as OpaqueRollup, type types_RadarRecord as RadarRecord, type types_RecordCommitmentInput as RecordCommitmentInput, type types_RecordInteractionInput as RecordInteractionInput, type types_RecordMilestoneInput as RecordMilestoneInput, type types_RecordObservationInput as RecordObservationInput, type types_RecordTransactionInput as RecordTransactionInput, type types_RelationalLinkKind as RelationalLinkKind, type types_ResolveCommitmentOptions as ResolveCommitmentOptions, type types_ReviseContactPatch as ReviseContactPatch, type types_ReviseDateAnchorOptions as ReviseDateAnchorOptions, type types_ReviseDateAnchorPatch as ReviseDateAnchorPatch, type types_ReviseEventPatch as ReviseEventPatch, type types_ReviseIdentityPatch as ReviseIdentityPatch, type types_SeedSocialLinkInput as SeedSocialLinkInput, type types_SetContactLifecycleOptions as SetContactLifecycleOptions, type types_SetStructuralTieInput as SetStructuralTieInput, type types_SocialEventInput as SocialEventInput, type types_SocialEventParticipantInput as SocialEventParticipantInput, type types_StructuralLinkKind as StructuralLinkKind, type types_UpcomingDateRecord as UpcomingDateRecord, type types_UpcomingDateTargetRef as UpcomingDateTargetRef, types_resolveAffinityListLimit as resolveAffinityListLimit };
 }
 
 declare function createContact(db: AffinityDb, input: CreateContactInput): ContactMutationReceipt;
@@ -900,27 +1056,51 @@ declare function undismissDuplicate(db: AffinityDb, leftContactId: number, right
 
 declare function listDismissedDuplicates(db: AffinityDb, options?: AffinityListReadOptions): DismissedDuplicateRecord[];
 
-declare function getContactJournal(db: AffinityDb, contactId: number, options?: ContactJournalReadOptions): EventRecord[];
-
-declare function listMoments(db: AffinityDb, filters?: ListMomentsFilters, options?: AffinityListReadOptions): MomentRecord[];
-
-declare function listOpenCommitments(db: AffinityDb, filters?: ListOpenCommitmentsFilters, options?: AffinityListReadOptions): CommitmentRecord[];
-
-declare function recordCommitment(db: AffinityDb, input: RecordCommitmentInput): EventMutationReceipt;
-
-declare function recordInteraction(db: AffinityDb, input: RecordInteractionInput): EventMutationReceipt;
-
-declare function recordMilestone(db: AffinityDb, input: RecordMilestoneInput): EventMutationReceipt;
-
-declare function recordObservation(db: AffinityDb, input: RecordObservationInput): EventMutationReceipt;
+/** Export all stored records belonging to a contact, including archived history. */
+declare function exportContact(db: AffinityDb, id: number): {
+    contact: Record<string, unknown>;
+    identities: Record<string, unknown>[];
+    attributes: Record<string, unknown>[];
+    links: Record<string, unknown>[];
+    events: (Record<string, unknown> & {
+        participants: Record<string, unknown>[];
+    })[];
+    commitments: Record<string, unknown>[];
+    dates: Record<string, unknown>[];
+    mergeHistory: Record<string, unknown>[];
+};
 
-declare function recordTransaction(db: AffinityDb, input: RecordTransactionInput): EventMutationReceipt;
+/** Export every contact, including merged and lost records. Version is the export format version. */
+declare function exportAffinity(db: AffinityDb): {
+    version: number;
+    exportedAt: number;
+    exportedAtIso: string;
+    events: (Record<string, unknown> & {
+        participants: Record<string, unknown>[];
+    })[];
+    contacts: {
+        eventIds: unknown[];
+        dateIds: unknown[];
+        contact: Record<string, unknown>;
+        identities: Record<string, unknown>[];
+        attributes: Record<string, unknown>[];
+        links: Record<string, unknown>[];
+        commitments: Record<string, unknown>[];
+        mergeHistory: Record<string, unknown>[];
+    }[];
+};
 
-declare function resolveCommitment(db: AffinityDb, commitmentEventId: number, resolution: CommitmentResolutionKind, options?: ResolveCommitmentOptions): EventMutationReceipt;
+declare function getEventById(db: AffinityDb, eventId: number): EventRecord | null;
+declare function getEventByExternalRef(db: AffinityDb, source: string, id: string): EventRecord | null;
 
+declare const read_exportAffinity: typeof exportAffinity;
+declare const read_exportContact: typeof exportContact;
 declare const read_getAffinityChart: typeof getAffinityChart;
 declare const read_getContactJournal: typeof getContactJournal;
 declare const read_getContactProfile: typeof getContactProfile;
+declare const read_getEventByExternalRef: typeof getEventByExternalRef;
+declare const read_getEventById: typeof getEventById;
+declare const read_getEventThread: typeof getEventThread;
 declare const read_getLinkDetail: typeof getLinkDetail;
 declare const read_getLinkTimeline: typeof getLinkTimeline;
 declare const read_getLinksBetween: typeof getLinksBetween;
@@ -937,8 +1117,9 @@ declare const read_listProgressionReadiness: typeof listProgressionReadiness;
 declare const read_listRadar: typeof listRadar;
 declare const read_listUpcomingDates: typeof listUpcomingDates;
 declare const read_searchContacts: typeof searchContacts;
+declare const read_searchEvents: typeof searchEvents;
 declare namespace read {
-  export { read_getAffinityChart as getAffinityChart, read_getContactJournal as getContactJournal, read_getContactProfile as getContactProfile, read_getLinkDetail as getLinkDetail, read_getLinkTimeline as getLinkTimeline, read_getLinksBetween as getLinksBetween, read_getMergeHistory as getMergeHistory, read_getOwnerProfile as getOwnerProfile, read_listContacts as listContacts, read_listDismissedDuplicates as listDismissedDuplicates, read_listDuplicateCandidates as listDuplicateCandidates, read_listMoments as listMoments, read_listObservedLinks as listObservedLinks, read_listOpenCommitments as listOpenCommitments, read_listOwnerSocialLinks as listOwnerSocialLinks, read_listProgressionReadiness as listProgressionReadiness, read_listRadar as listRadar, read_listUpcomingDates as listUpcomingDates, read_searchContacts as searchContacts };
+  export { read_exportAffinity as exportAffinity, read_exportContact as exportContact, read_getAffinityChart as getAffinityChart, read_getContactJournal as getContactJournal, read_getContactProfile as getContactProfile, read_getEventByExternalRef as getEventByExternalRef, read_getEventById as getEventById, read_getEventThread as getEventThread, read_getLinkDetail as getLinkDetail, read_getLinkTimeline as getLinkTimeline, read_getLinksBetween as getLinksBetween, read_getMergeHistory as getMergeHistory, read_getOwnerProfile as getOwnerProfile, read_listContacts as listContacts, read_listDismissedDuplicates as listDismissedDuplicates, read_listDuplicateCandidates as listDuplicateCandidates, read_listMoments as listMoments, read_listObservedLinks as listObservedLinks, read_listOpenCommitments as listOpenCommitments, read_listOwnerSocialLinks as listOwnerSocialLinks, read_listProgressionReadiness as listProgressionReadiness, read_listRadar as listRadar, read_listUpcomingDates as listUpcomingDates, read_searchContacts as searchContacts, read_searchEvents as searchEvents };
 }
 
 interface AffinitySoulTrait {
@@ -1081,7 +1262,7 @@ type ToolEntityKind = "contact" | "identity" | "link" | "event" | "attribute";
 type ToolOutcomeKind = "success" | "no_op" | "needs_clarification" | "error";
 type ToolErrorCode = "clarification_needed" | "conflict" | "constraint_violation" | "invalid_input" | "invalid_state" | "not_found" | "system_error" | "unsupported_target";
 type ToolErrorKind = "domain" | "protocol" | "system";
-type ToolWarningCode = "already_in_state" | "derived_value_used" | "empty_result" | "partial_match" | "unchanged";
+type ToolWarningCode = "already_in_state" | "derived_value_used" | "empty_result" | "future_event" | "possible_duplicate" | "partial_match" | "unchanged";
 type ToolClarificationCode = "ambiguous_target" | "missing_required_choice" | "multiple_plausible_matches";
 type ToolNextStepHintKind = "ask_user" | "inspect_item" | "review_view" | "retry_with" | "use_tool";
 interface ToolEntityRef {
@@ -1092,9 +1273,12 @@ interface ToolEntityRef {
     state?: ContactLifecycleState | EventType | LinkKind | LinkState | ContactKind | string | null | undefined;
 }
 interface ToolListItem extends ToolEntityRef {
+    [key: string]: unknown;
     snippet?: string | undefined;
 }
 interface ToolWarning {
+    contactId?: number;
+    score?: number;
     code: ToolWarningCode;
     message: string;
 }
@@ -1131,6 +1315,9 @@ interface ToolNeedsClarification extends ToolBaseResult {
     };
 }
 interface ToolFailure extends ToolBaseResult {
+    data?: {
+        existingContactId: number;
+    };
     ok: false;
     outcome: "error";
     error: {
@@ -1206,6 +1393,11 @@ declare function objectSchema(properties: Record<string, JsonSchema>, required:
 declare function nullableStringSchema(description: string): JsonSchema;
 declare function oneOfSchema(schemas: ReadonlyArray<JsonSchema>, description?: string): JsonSchema;
 
+type TimeInputs<T> = T extends readonly (infer U)[] ? readonly TimeInputs<U>[] : T extends object ? {
+    [K in keyof T]: K extends `${string}At` | "now" | "asOf" | "since" | "until" ? T[K] | string : TimeInputs<T[K]>;
+} : T;
+declare function parseTimeInput(value: number | string, field?: string, now?: number): number;
+
 type ContactLocator = {
     contactId: number;
 } | {
@@ -1232,17 +1424,22 @@ type ResolvedTarget<T> = {
     ok: false;
     result: ToolFailure | ToolNeedsClarification;
 };
-declare function resolveContactLocator(db: AffinityDb, locator: ContactLocator, field?: string): ResolvedTarget<ContactRow>;
+declare function resolveContactLocator(db: AffinityDb, locator: ContactLocator, field?: string, allowMerged?: boolean): ResolvedTarget<ContactRow>;
 declare function resolveLinkLocator(db: AffinityDb, locator: LinkLocator, field?: string): ResolvedTarget<LinkRow>;
 declare function mapErrorToToolFailure(error: unknown, summary?: string): ToolFailure;
 declare function withToolHandling<TData>(operation: () => ToolResult<TData>, summary?: string): ToolResult<TData>;
 
 type InspectAffinityItemToolInput = {
+    kind: "event";
+    eventId?: number;
+    ref?: ExternalRef;
+} | {
     kind: "owner_profile";
     topLinksLimit?: number;
 } | {
     kind: "contact_profile";
     contact: ContactLocator;
+    recentEventsLimit?: number;
     topLinksLimit?: number;
 } | {
     kind: "link";
@@ -1250,6 +1447,9 @@ type InspectAffinityItemToolInput = {
     recentEventsLimit?: number;
 };
 type InspectAffinityItemToolData = {
+    kind: "event";
+    detail: EventRecord;
+} | {
     kind: "owner_profile";
     detail: ContactProfileRecord;
 } | {
@@ -1260,12 +1460,19 @@ type InspectAffinityItemToolData = {
     detail: LinkDetailRecord;
 };
 type InspectAffinityItemToolResult = ToolResult<InspectAffinityItemToolData>;
-declare function inspectAffinityItemToolHandler(db: AffinityDb, input: InspectAffinityItemToolInput): InspectAffinityItemToolResult;
-declare const inspectAffinityItemTool: AffinityToolDefinition<InspectAffinityItemToolInput, InspectAffinityItemToolResult>;
+declare function inspectAffinityItemToolHandler(db: AffinityDb, rawInput: TimeInputs<InspectAffinityItemToolInput>): InspectAffinityItemToolResult;
+declare const inspectAffinityItemTool: AffinityToolDefinition<TimeInputs<InspectAffinityItemToolInput>, InspectAffinityItemToolResult>;
 
 interface MutationToolData<TPrimary> {
+    changes: {
+        entity: string;
+        id: number;
+        action: string;
+        fields?: string[];
+    }[];
     action: string;
     primary: TPrimary;
+    matchedIdentities?: AddIdentityInput[];
     created: MutationReceipt<TPrimary>["created"];
     updated: MutationReceipt<TPrimary>["updated"];
     archived: MutationReceipt<TPrimary>["archived"];
@@ -1273,7 +1480,7 @@ interface MutationToolData<TPrimary> {
     affectedLinks: number[];
     derivedEffects: MutationReceipt<TPrimary>["derivedEffects"];
 }
-declare function mutationToolResult<TPrimary>(action: string, receipt: MutationReceipt<TPrimary>, entitySummary: string): ToolResult<MutationToolData<TPrimary>>;
+declare function mutationToolResult<TPrimary>(action: string, receipt: MutationReceipt<TPrimary>, entitySummary: string, fields?: string[]): ToolResult<MutationToolData<TPrimary>>;
 
 type AttributeTargetInput = {
     kind: "contact";
@@ -1281,6 +1488,9 @@ type AttributeTargetInput = {
 } | {
     kind: "link";
     link: LinkLocator;
+} | {
+    kind: "event";
+    eventId: number;
 };
 type ManageAttributeToolInput = {
     action: "set";
@@ -1298,8 +1508,8 @@ type ManageAttributeToolInput = {
     entries: AttributeEntry[];
 };
 type ManageAttributeToolResult = ToolResult<MutationToolData<AttributeRecord>>;
-declare function manageAttributeToolHandler(db: AffinityDb, input: ManageAttributeToolInput): ManageAttributeToolResult;
-declare const manageAttributeTool: AffinityToolDefinition<ManageAttributeToolInput, ManageAttributeToolResult>;
+declare function manageAttributeToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageAttributeToolInput>): ManageAttributeToolResult;
+declare const manageAttributeTool: AffinityToolDefinition<TimeInputs<ManageAttributeToolInput>, ManageAttributeToolResult>;
 
 type ManageCommitmentToolInput = {
     action: "record";
@@ -1311,12 +1521,34 @@ type ManageCommitmentToolInput = {
     options?: ResolveCommitmentOptions;
 };
 type ManageCommitmentToolResult = ToolResult<MutationToolData<EventRecord>>;
-declare function manageCommitmentToolHandler(db: AffinityDb, input: ManageCommitmentToolInput): ManageCommitmentToolResult;
-declare const manageCommitmentTool: AffinityToolDefinition<ManageCommitmentToolInput, ManageCommitmentToolResult>;
+declare function manageCommitmentToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageCommitmentToolInput>): ManageCommitmentToolResult;
+declare const manageCommitmentTool: AffinityToolDefinition<TimeInputs<ManageCommitmentToolInput>, ManageCommitmentToolResult>;
+
+/** Permanently erase a contact and dependent records. The owner cannot be erased. */
+declare function deleteContact(db: AffinityDb, locatorId: number, options: {
+    confirm?: boolean;
+}): {
+    contactId: number;
+    removed: {
+        entity: string;
+        count: number;
+        ids: number[];
+    }[];
+    affectedLinks: number[];
+};
 
 type ManageContactToolInput = {
+    action: "export";
+    contact?: ContactLocator;
+} | {
+    action: "delete";
+    contact: ContactLocator;
+    confirm?: boolean;
+} | {
     action: "create";
-    input: CreateContactInput;
+    input: CreateContactInput & {
+        identities?: AddIdentityInput[];
+    };
 } | {
     action: "revise";
     contact: ContactLocator;
@@ -1327,9 +1559,23 @@ type ManageContactToolInput = {
     lifecycleState: ContactLifecycleState;
     options?: SetContactLifecycleOptions;
 };
-type ManageContactToolResult = ToolResult<MutationToolData<ContactListItem>>;
-declare function manageContactToolHandler(db: AffinityDb, input: ManageContactToolInput): ManageContactToolResult;
-declare const manageContactTool: AffinityToolDefinition<ManageContactToolInput, ManageContactToolResult>;
+type ManageContactToolResult = ToolResult<MutationToolData<ContactListItem> | {
+    action: "export";
+    export: ReturnType<typeof exportContact> | ReturnType<typeof exportAffinity>;
+} | {
+    action: "delete";
+    deletion: ReturnType<typeof deleteContact>;
+    changes: {
+        entity: string;
+        id: number;
+        action: string;
+    }[];
+}>;
+declare function manageContactToolHandler(db: AffinityDb, input: TimeInputs<Exclude<ManageContactToolInput, {
+    action: "export" | "delete";
+}>>): ToolResult<MutationToolData<ContactListItem>>;
+declare function manageContactToolHandler(db: AffinityDb, input: TimeInputs<ManageContactToolInput>): ManageContactToolResult;
+declare const manageContactTool: AffinityToolDefinition<TimeInputs<ManageContactToolInput>, ManageContactToolResult>;
 
 interface ManageDuplicateDismissalToolInput {
     action: "dismiss" | "undismiss";
@@ -1337,13 +1583,36 @@ interface ManageDuplicateDismissalToolInput {
     right: ContactLocator;
     reason?: string | null;
 }
-interface DismissalToolData {
-    action: string;
-    primary: DismissedPairRef;
-}
+type DismissalToolData = Omit<MutationToolData<DismissedPairRef>, "changes"> & {
+    changes: {
+        entity: "duplicate_dismissal";
+        leftContactId: number;
+        rightContactId: number;
+        action: string;
+    }[];
+};
 type ManageDuplicateDismissalToolResult = ToolResult<DismissalToolData>;
-declare function manageDuplicateDismissalToolHandler(db: AffinityDb, input: ManageDuplicateDismissalToolInput): ManageDuplicateDismissalToolResult;
-declare const manageDuplicateDismissalTool: AffinityToolDefinition<ManageDuplicateDismissalToolInput, ManageDuplicateDismissalToolResult>;
+declare function manageDuplicateDismissalToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageDuplicateDismissalToolInput>): ManageDuplicateDismissalToolResult;
+declare const manageDuplicateDismissalTool: AffinityToolDefinition<{
+    action: "dismiss" | "undismiss";
+    left: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    right: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reason?: string | null;
+}, ManageDuplicateDismissalToolResult>;
 
 type DateAnchorTargetInput = {
     kind: "contact";
@@ -1368,8 +1637,8 @@ type ManageDateAnchorToolInput = {
     removedAt?: number;
 };
 type ManageDateAnchorToolResult = ToolResult<MutationToolData<EventRecord>>;
-declare function manageDateAnchorToolHandler(db: AffinityDb, input: ManageDateAnchorToolInput): ManageDateAnchorToolResult;
-declare const manageDateAnchorTool: AffinityToolDefinition<ManageDateAnchorToolInput, ManageDateAnchorToolResult>;
+declare function manageDateAnchorToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageDateAnchorToolInput>): ManageDateAnchorToolResult;
+declare const manageDateAnchorTool: AffinityToolDefinition<TimeInputs<ManageDateAnchorToolInput>, ManageDateAnchorToolResult>;
 
 type ManageIdentityToolInput = {
     action: "add";
@@ -1389,8 +1658,8 @@ type ManageIdentityToolInput = {
     removedAt?: number;
 };
 type ManageIdentityToolResult = ToolResult<MutationToolData<IdentityRecord>>;
-declare function manageIdentityToolHandler(db: AffinityDb, input: ManageIdentityToolInput): ManageIdentityToolResult;
-declare const manageIdentityTool: AffinityToolDefinition<ManageIdentityToolInput, ManageIdentityToolResult>;
+declare function manageIdentityToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageIdentityToolInput>): ManageIdentityToolResult;
+declare const manageIdentityTool: AffinityToolDefinition<TimeInputs<ManageIdentityToolInput>, ManageIdentityToolResult>;
 
 type ManageRelationshipToolInput = {
     action: "seed_social_link";
@@ -1422,8 +1691,8 @@ type ManageRelationshipToolInput = {
     removedAt?: number;
 };
 type ManageRelationshipToolResult = ToolResult<MutationToolData<LinkListItem>>;
-declare function manageRelationshipToolHandler(db: AffinityDb, input: ManageRelationshipToolInput): ManageRelationshipToolResult;
-declare const manageRelationshipTool: AffinityToolDefinition<ManageRelationshipToolInput, ManageRelationshipToolResult>;
+declare function manageRelationshipToolHandler(db: AffinityDb, rawInput: TimeInputs<ManageRelationshipToolInput>): ManageRelationshipToolResult;
+declare const manageRelationshipTool: AffinityToolDefinition<TimeInputs<ManageRelationshipToolInput>, ManageRelationshipToolResult>;
 
 interface MergeContactsToolInput {
     winner: ContactLocator;
@@ -1432,35 +1701,70 @@ interface MergeContactsToolInput {
     now?: number;
 }
 type MergeContactsToolResult = ToolResult<MutationToolData<MergePrimary>>;
-declare function mergeContactsToolHandler(db: AffinityDb, input: MergeContactsToolInput): MergeContactsToolResult;
-declare const mergeContactsTool: AffinityToolDefinition<MergeContactsToolInput, MergeContactsToolResult>;
+declare function mergeContactsToolHandler(db: AffinityDb, rawInput: TimeInputs<MergeContactsToolInput>): MergeContactsToolResult;
+declare const mergeContactsTool: AffinityToolDefinition<{
+    winner: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    loser: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reasonSummary?: string | null;
+    now?: string | number;
+}, MergeContactsToolResult>;
 
+type ToolEvidence<T extends {
+    participants: readonly SocialEventParticipantInput[];
+}> = Omit<T, "participants"> & {
+    participants: readonly (SocialEventParticipantInput | {
+        contact: ContactLocator;
+        role: SocialEventParticipantInput["role"];
+        directionality?: SocialEventParticipantInput["directionality"];
+    })[];
+};
 type RecordEventToolInput = {
     kind: "interaction";
-    input: RecordInteractionInput;
+    input: ToolEvidence<RecordInteractionInput>;
 } | {
     kind: "observation";
-    input: RecordObservationInput;
+    input: ToolEvidence<RecordObservationInput>;
 } | {
     kind: "milestone";
-    input: RecordMilestoneInput;
+    input: ToolEvidence<RecordMilestoneInput>;
 } | {
     kind: "transaction";
-    input: RecordTransactionInput;
+    input: ToolEvidence<RecordTransactionInput>;
 };
 type RecordEventToolResult = ToolResult<MutationToolData<EventRecord>>;
-declare function recordEventToolHandler(db: AffinityDb, input: RecordEventToolInput): RecordEventToolResult;
-declare const recordEventTool: AffinityToolDefinition<RecordEventToolInput, RecordEventToolResult>;
+declare function recordEventToolHandler(db: AffinityDb, rawInput: TimeInputs<RecordEventToolInput>): RecordEventToolResult;
+declare const recordEventTool: AffinityToolDefinition<TimeInputs<RecordEventToolInput>, RecordEventToolResult>;
 
-type ReviewAffinityToolView = "contacts.list" | "contacts.duplicates" | "events.contact_journal" | "events.link_timeline" | "events.moments" | "commitments.open" | "links.owner" | "links.observed" | "links.progression_readiness" | "links.radar" | "dates.upcoming" | "graph.chart" | "merges.history" | "merges.dismissed";
+type ReviewAffinityToolView = "contacts.list" | "contacts.duplicates" | "events.thread" | "events.contact_journal" | "events.link_timeline" | "events.moments" | "commitments.open" | "links.owner" | "links.observed" | "links.progression_readiness" | "links.radar" | "dates.upcoming" | "graph.chart" | "merges.history" | "merges.dismissed";
 interface ReviewAffinityToolInput {
+    ref?: ExternalRef;
+    includeContent?: boolean;
+    channel?: string;
     view: ReviewAffinityToolView;
+    now?: number;
     contact?: ContactLocator;
     link?: LinkLocator;
     contactIds?: number[];
     kind?: ContactKind | LinkKind;
     lifecycleState?: ContactLifecycleState;
     linkState?: LinkState;
+    attribute?: string | string[];
+    tag?: string | string[];
+    includeLost?: boolean;
     includeOwner?: boolean;
     includeDormant?: boolean;
     includeArchived?: boolean;
@@ -1482,12 +1786,65 @@ interface ReviewAffinityToolData {
     view: ReviewAffinityToolView;
     items: ToolListItem[];
     count: number;
+    total?: number;
+    hasMore?: boolean;
     appliedFilters: Record<string, unknown>;
     chart?: AffinityChartRecord | undefined;
 }
 type ReviewAffinityToolResult = ToolResult<ReviewAffinityToolData>;
-declare function reviewAffinityToolHandler(db: AffinityDb, input: ReviewAffinityToolInput): ReviewAffinityToolResult;
-declare const reviewAffinityTool: AffinityToolDefinition<ReviewAffinityToolInput, ReviewAffinityToolResult>;
+declare function reviewAffinityToolHandler(db: AffinityDb, rawInput: TimeInputs<ReviewAffinityToolInput>): ReviewAffinityToolResult;
+declare const reviewAffinityTool: AffinityToolDefinition<{
+    ref?: {
+        source: string;
+        id: string;
+    };
+    includeContent?: boolean;
+    channel?: string;
+    view: ReviewAffinityToolView;
+    now?: string | number;
+    contact?: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    link?: {
+        linkId: number;
+    } | {
+        endpoints: {
+            fromContactId: number;
+            toContactId: number;
+            kind?: string | undefined | undefined;
+            role?: string | null | undefined | undefined;
+            isStructural?: boolean | undefined | undefined;
+        };
+    };
+    contactIds?: readonly number[];
+    kind?: ContactKind | LinkKind;
+    lifecycleState?: ContactLifecycleState;
+    linkState?: LinkState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    includeArchived?: boolean;
+    includeObserved?: boolean;
+    eventTypes?: readonly EventType[];
+    momentKind?: EventMomentKind;
+    commitmentType?: "promise" | "agreement";
+    recurrenceKind?: EventRecurrenceKind;
+    horizonDays?: number;
+    exactOnly?: boolean;
+    minScore?: number;
+    includeDismissed?: boolean;
+    since?: string | number;
+    until?: string | number;
+    limit?: number;
+    offset?: number;
+}, ReviewAffinityToolResult>;
 
 declare function toContactEntityRef(value: ContactCore | ContactListItem | ContactRow): ToolEntityRef;
 declare function toContactListToolItem(value: ContactCore | ContactListItem | ContactRow): ToolListItem;
@@ -1503,9 +1860,13 @@ declare function toMutationRefEntity(ref: EntityRef): ToolEntityRef;
 declare function toReceiptEntityRefs<TPrimary>(receipt: MutationReceipt<TPrimary>): ToolEntityRef[];
 
 interface SearchAffinityToolInput {
+    scope?: "contacts" | "events" | "all";
     query: string;
     kind?: ContactKind;
     lifecycleState?: ContactLifecycleState;
+    attribute?: string | string[];
+    tag?: string | string[];
+    includeLost?: boolean;
     includeOwner?: boolean;
     includeDormant?: boolean;
     limit?: number;
@@ -1515,14 +1876,422 @@ interface SearchAffinityToolData {
     query: string;
     items: ReturnType<typeof toContactListToolItem>[];
     count: number;
+    total?: number;
+    hasMore?: boolean;
 }
 type SearchAffinityToolResult = ToolResult<SearchAffinityToolData>;
-declare function searchAffinityToolHandler(db: AffinityDb, input: SearchAffinityToolInput): SearchAffinityToolResult;
-declare const searchAffinityTool: AffinityToolDefinition<SearchAffinityToolInput, SearchAffinityToolResult>;
+declare function searchAffinityToolHandler(db: AffinityDb, rawInput: TimeInputs<SearchAffinityToolInput>): SearchAffinityToolResult;
+declare const searchAffinityTool: AffinityToolDefinition<{
+    scope?: "contacts" | "events" | "all";
+    query: string;
+    kind?: ContactKind;
+    lifecycleState?: ContactLifecycleState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    limit?: number;
+    offset?: number;
+}, SearchAffinityToolResult>;
+
+interface ManageEventToolInput {
+    action: "revise" | "delete";
+    eventId?: number;
+    ref?: ExternalRef;
+    patch?: ReviseEventPatch;
+    confirm?: boolean;
+}
+type ManageEventToolResult = ToolResult<MutationToolData<EventRecord>>;
+declare function manageEventToolHandler(db: AffinityDb, raw: TimeInputs<ManageEventToolInput>): ManageEventToolResult;
+declare const manageEventTool: AffinityToolDefinition<{
+    action: "revise" | "delete";
+    eventId?: number;
+    ref?: {
+        source: string;
+        id: string;
+    };
+    patch?: {
+        summary?: string;
+        content?: string;
+        occurredAt?: string | number;
+        significance?: number;
+        channel?: string;
+        type?: EventType;
+        externalRef?: {
+            source: string;
+            id: string;
+        };
+    };
+    confirm?: boolean;
+}, ManageEventToolResult>;
 
-declare const affinityTools: (AffinityToolDefinition<InspectAffinityItemToolInput, InspectAffinityItemToolResult> | AffinityToolDefinition<ManageAttributeToolInput, ManageAttributeToolResult> | AffinityToolDefinition<ManageCommitmentToolInput, ManageCommitmentToolResult> | AffinityToolDefinition<ManageContactToolInput, ManageContactToolResult> | AffinityToolDefinition<ManageDuplicateDismissalToolInput, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<ManageDateAnchorToolInput, ManageDateAnchorToolResult> | AffinityToolDefinition<ManageIdentityToolInput, ManageIdentityToolResult> | AffinityToolDefinition<ManageRelationshipToolInput, ManageRelationshipToolResult> | AffinityToolDefinition<MergeContactsToolInput, MergeContactsToolResult> | AffinityToolDefinition<RecordEventToolInput, RecordEventToolResult> | AffinityToolDefinition<ReviewAffinityToolInput, ReviewAffinityToolResult> | AffinityToolDefinition<SearchAffinityToolInput, SearchAffinityToolResult>)[];
-declare function listAffinityToolDefinitions(): (AffinityToolDefinition<InspectAffinityItemToolInput, InspectAffinityItemToolResult> | AffinityToolDefinition<ManageAttributeToolInput, ManageAttributeToolResult> | AffinityToolDefinition<ManageCommitmentToolInput, ManageCommitmentToolResult> | AffinityToolDefinition<ManageContactToolInput, ManageContactToolResult> | AffinityToolDefinition<ManageDuplicateDismissalToolInput, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<ManageDateAnchorToolInput, ManageDateAnchorToolResult> | AffinityToolDefinition<ManageIdentityToolInput, ManageIdentityToolResult> | AffinityToolDefinition<ManageRelationshipToolInput, ManageRelationshipToolResult> | AffinityToolDefinition<MergeContactsToolInput, MergeContactsToolResult> | AffinityToolDefinition<RecordEventToolInput, RecordEventToolResult> | AffinityToolDefinition<ReviewAffinityToolInput, ReviewAffinityToolResult> | AffinityToolDefinition<SearchAffinityToolInput, SearchAffinityToolResult>)[];
-declare function getAffinityToolByName(name: string): AffinityToolDefinition<InspectAffinityItemToolInput, InspectAffinityItemToolResult> | AffinityToolDefinition<ManageAttributeToolInput, ManageAttributeToolResult> | AffinityToolDefinition<ManageCommitmentToolInput, ManageCommitmentToolResult> | AffinityToolDefinition<ManageContactToolInput, ManageContactToolResult> | AffinityToolDefinition<ManageDuplicateDismissalToolInput, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<ManageDateAnchorToolInput, ManageDateAnchorToolResult> | AffinityToolDefinition<ManageIdentityToolInput, ManageIdentityToolResult> | AffinityToolDefinition<ManageRelationshipToolInput, ManageRelationshipToolResult> | AffinityToolDefinition<MergeContactsToolInput, MergeContactsToolResult> | AffinityToolDefinition<RecordEventToolInput, RecordEventToolResult> | AffinityToolDefinition<ReviewAffinityToolInput, ReviewAffinityToolResult> | AffinityToolDefinition<SearchAffinityToolInput, SearchAffinityToolResult> | null;
+declare const affinityTools: (AffinityToolDefinition<TimeInputs<InspectAffinityItemToolInput>, InspectAffinityItemToolResult> | AffinityToolDefinition<TimeInputs<ManageAttributeToolInput>, ManageAttributeToolResult> | AffinityToolDefinition<TimeInputs<ManageCommitmentToolInput>, ManageCommitmentToolResult> | AffinityToolDefinition<TimeInputs<ManageContactToolInput>, ManageContactToolResult> | AffinityToolDefinition<{
+    action: "dismiss" | "undismiss";
+    left: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    right: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reason?: string | null;
+}, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<TimeInputs<ManageDateAnchorToolInput>, ManageDateAnchorToolResult> | AffinityToolDefinition<TimeInputs<ManageIdentityToolInput>, ManageIdentityToolResult> | AffinityToolDefinition<TimeInputs<ManageRelationshipToolInput>, ManageRelationshipToolResult> | AffinityToolDefinition<{
+    winner: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    loser: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reasonSummary?: string | null;
+    now?: string | number;
+}, MergeContactsToolResult> | AffinityToolDefinition<TimeInputs<RecordEventToolInput>, RecordEventToolResult> | AffinityToolDefinition<{
+    ref?: {
+        source: string;
+        id: string;
+    };
+    includeContent?: boolean;
+    channel?: string;
+    view: ReviewAffinityToolView;
+    now?: string | number;
+    contact?: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    link?: {
+        linkId: number;
+    } | {
+        endpoints: {
+            fromContactId: number;
+            toContactId: number;
+            kind?: string | undefined | undefined;
+            role?: string | null | undefined | undefined;
+            isStructural?: boolean | undefined | undefined;
+        };
+    };
+    contactIds?: readonly number[];
+    kind?: ContactKind | LinkKind;
+    lifecycleState?: ContactLifecycleState;
+    linkState?: LinkState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    includeArchived?: boolean;
+    includeObserved?: boolean;
+    eventTypes?: readonly EventType[];
+    momentKind?: EventMomentKind;
+    commitmentType?: "promise" | "agreement";
+    recurrenceKind?: EventRecurrenceKind;
+    horizonDays?: number;
+    exactOnly?: boolean;
+    minScore?: number;
+    includeDismissed?: boolean;
+    since?: string | number;
+    until?: string | number;
+    limit?: number;
+    offset?: number;
+}, ReviewAffinityToolResult> | AffinityToolDefinition<{
+    scope?: "contacts" | "events" | "all";
+    query: string;
+    kind?: ContactKind;
+    lifecycleState?: ContactLifecycleState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    limit?: number;
+    offset?: number;
+}, SearchAffinityToolResult> | AffinityToolDefinition<{
+    action: "revise" | "delete";
+    eventId?: number;
+    ref?: {
+        source: string;
+        id: string;
+    };
+    patch?: {
+        summary?: string;
+        content?: string;
+        occurredAt?: string | number;
+        significance?: number;
+        channel?: string;
+        type?: EventType;
+        externalRef?: {
+            source: string;
+            id: string;
+        };
+    };
+    confirm?: boolean;
+}, ManageEventToolResult>)[];
+declare function listAffinityToolDefinitions(): (AffinityToolDefinition<TimeInputs<InspectAffinityItemToolInput>, InspectAffinityItemToolResult> | AffinityToolDefinition<TimeInputs<ManageAttributeToolInput>, ManageAttributeToolResult> | AffinityToolDefinition<TimeInputs<ManageCommitmentToolInput>, ManageCommitmentToolResult> | AffinityToolDefinition<TimeInputs<ManageContactToolInput>, ManageContactToolResult> | AffinityToolDefinition<{
+    action: "dismiss" | "undismiss";
+    left: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    right: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reason?: string | null;
+}, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<TimeInputs<ManageDateAnchorToolInput>, ManageDateAnchorToolResult> | AffinityToolDefinition<TimeInputs<ManageIdentityToolInput>, ManageIdentityToolResult> | AffinityToolDefinition<TimeInputs<ManageRelationshipToolInput>, ManageRelationshipToolResult> | AffinityToolDefinition<{
+    winner: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    loser: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reasonSummary?: string | null;
+    now?: string | number;
+}, MergeContactsToolResult> | AffinityToolDefinition<TimeInputs<RecordEventToolInput>, RecordEventToolResult> | AffinityToolDefinition<{
+    ref?: {
+        source: string;
+        id: string;
+    };
+    includeContent?: boolean;
+    channel?: string;
+    view: ReviewAffinityToolView;
+    now?: string | number;
+    contact?: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    link?: {
+        linkId: number;
+    } | {
+        endpoints: {
+            fromContactId: number;
+            toContactId: number;
+            kind?: string | undefined | undefined;
+            role?: string | null | undefined | undefined;
+            isStructural?: boolean | undefined | undefined;
+        };
+    };
+    contactIds?: readonly number[];
+    kind?: ContactKind | LinkKind;
+    lifecycleState?: ContactLifecycleState;
+    linkState?: LinkState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    includeArchived?: boolean;
+    includeObserved?: boolean;
+    eventTypes?: readonly EventType[];
+    momentKind?: EventMomentKind;
+    commitmentType?: "promise" | "agreement";
+    recurrenceKind?: EventRecurrenceKind;
+    horizonDays?: number;
+    exactOnly?: boolean;
+    minScore?: number;
+    includeDismissed?: boolean;
+    since?: string | number;
+    until?: string | number;
+    limit?: number;
+    offset?: number;
+}, ReviewAffinityToolResult> | AffinityToolDefinition<{
+    scope?: "contacts" | "events" | "all";
+    query: string;
+    kind?: ContactKind;
+    lifecycleState?: ContactLifecycleState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    limit?: number;
+    offset?: number;
+}, SearchAffinityToolResult> | AffinityToolDefinition<{
+    action: "revise" | "delete";
+    eventId?: number;
+    ref?: {
+        source: string;
+        id: string;
+    };
+    patch?: {
+        summary?: string;
+        content?: string;
+        occurredAt?: string | number;
+        significance?: number;
+        channel?: string;
+        type?: EventType;
+        externalRef?: {
+            source: string;
+            id: string;
+        };
+    };
+    confirm?: boolean;
+}, ManageEventToolResult>)[];
+declare function getAffinityToolByName(name: string): AffinityToolDefinition<TimeInputs<InspectAffinityItemToolInput>, InspectAffinityItemToolResult> | AffinityToolDefinition<TimeInputs<ManageAttributeToolInput>, ManageAttributeToolResult> | AffinityToolDefinition<TimeInputs<ManageCommitmentToolInput>, ManageCommitmentToolResult> | AffinityToolDefinition<TimeInputs<ManageContactToolInput>, ManageContactToolResult> | AffinityToolDefinition<{
+    action: "dismiss" | "undismiss";
+    left: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    right: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reason?: string | null;
+}, ManageDuplicateDismissalToolResult> | AffinityToolDefinition<TimeInputs<ManageDateAnchorToolInput>, ManageDateAnchorToolResult> | AffinityToolDefinition<TimeInputs<ManageIdentityToolInput>, ManageIdentityToolResult> | AffinityToolDefinition<TimeInputs<ManageRelationshipToolInput>, ManageRelationshipToolResult> | AffinityToolDefinition<{
+    winner: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    loser: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    reasonSummary?: string | null;
+    now?: string | number;
+}, MergeContactsToolResult> | AffinityToolDefinition<TimeInputs<RecordEventToolInput>, RecordEventToolResult> | AffinityToolDefinition<{
+    ref?: {
+        source: string;
+        id: string;
+    };
+    includeContent?: boolean;
+    channel?: string;
+    view: ReviewAffinityToolView;
+    now?: string | number;
+    contact?: {
+        contactId: number;
+    } | {
+        identity: {
+            type: string;
+            value: string;
+        };
+    };
+    link?: {
+        linkId: number;
+    } | {
+        endpoints: {
+            fromContactId: number;
+            toContactId: number;
+            kind?: string | undefined | undefined;
+            role?: string | null | undefined | undefined;
+            isStructural?: boolean | undefined | undefined;
+        };
+    };
+    contactIds?: readonly number[];
+    kind?: ContactKind | LinkKind;
+    lifecycleState?: ContactLifecycleState;
+    linkState?: LinkState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    includeArchived?: boolean;
+    includeObserved?: boolean;
+    eventTypes?: readonly EventType[];
+    momentKind?: EventMomentKind;
+    commitmentType?: "promise" | "agreement";
+    recurrenceKind?: EventRecurrenceKind;
+    horizonDays?: number;
+    exactOnly?: boolean;
+    minScore?: number;
+    includeDismissed?: boolean;
+    since?: string | number;
+    until?: string | number;
+    limit?: number;
+    offset?: number;
+}, ReviewAffinityToolResult> | AffinityToolDefinition<{
+    scope?: "contacts" | "events" | "all";
+    query: string;
+    kind?: ContactKind;
+    lifecycleState?: ContactLifecycleState;
+    attribute?: string | readonly string[];
+    tag?: string | readonly string[];
+    includeLost?: boolean;
+    includeOwner?: boolean;
+    includeDormant?: boolean;
+    limit?: number;
+    offset?: number;
+}, SearchAffinityToolResult> | AffinityToolDefinition<{
+    action: "revise" | "delete";
+    eventId?: number;
+    ref?: {
+        source: string;
+        id: string;
+    };
+    patch?: {
+        summary?: string;
+        content?: string;
+        occurredAt?: string | number;
+        significance?: number;
+        channel?: string;
+        type?: EventType;
+        externalRef?: {
+            source: string;
+            id: string;
+        };
+    };
+    confirm?: boolean;
+}, ManageEventToolResult> | null;
 
 interface AffinityToolMapping {
     source: string;
@@ -1545,6 +2314,7 @@ declare const recordEventToolName = "record_event";
 declare const manageCommitmentToolName = "manage_commitment";
 declare const manageDateAnchorToolName = "manage_date_anchor";
 declare const manageAttributeToolName = "manage_attribute";
+declare const manageEventToolName = "manage_event";
 
 declare function summarizeCount(count: number, singular: string): string;
 
@@ -1554,6 +2324,8 @@ type index_ContactLocator = ContactLocator;
 type index_JsonSchema = JsonSchema;
 type index_JsonSchemaType = JsonSchemaType;
 type index_LinkLocator = LinkLocator;
+type index_ManageEventToolInput = ManageEventToolInput;
+type index_ManageEventToolResult = ManageEventToolResult;
 type index_MutationToolData<TPrimary> = MutationToolData<TPrimary>;
 type index_ResolvedTarget<T> = ResolvedTarget<T>;
 type index_ToolBaseResult = ToolBaseResult;
@@ -1599,6 +2371,9 @@ declare const index_manageDateAnchorToolName: typeof manageDateAnchorToolName;
 declare const index_manageDuplicateDismissalTool: typeof manageDuplicateDismissalTool;
 declare const index_manageDuplicateDismissalToolHandler: typeof manageDuplicateDismissalToolHandler;
 declare const index_manageDuplicateDismissalToolName: typeof manageDuplicateDismissalToolName;
+declare const index_manageEventTool: typeof manageEventTool;
+declare const index_manageEventToolHandler: typeof manageEventToolHandler;
+declare const index_manageEventToolName: typeof manageEventToolName;
 declare const index_manageIdentityTool: typeof manageIdentityTool;
 declare const index_manageIdentityToolHandler: typeof manageIdentityToolHandler;
 declare const index_manageIdentityToolName: typeof manageIdentityToolName;
@@ -1614,6 +2389,7 @@ declare const index_nullableStringSchema: typeof nullableStringSchema;
 declare const index_numberSchema: typeof numberSchema;
 declare const index_objectSchema: typeof objectSchema;
 declare const index_oneOfSchema: typeof oneOfSchema;
+declare const index_parseTimeInput: typeof parseTimeInput;
 declare const index_recordEventTool: typeof recordEventTool;
 declare const index_recordEventToolHandler: typeof recordEventToolHandler;
 declare const index_recordEventToolName: typeof recordEventToolName;
@@ -1646,7 +2422,7 @@ declare const index_toolSuccess: typeof toolSuccess;
 declare const index_toolWarning: typeof toolWarning;
 declare const index_withToolHandling: typeof withToolHandling;
 declare namespace index {
-  export { type index_AffinityToolDefinition as AffinityToolDefinition, type index_AffinityToolMapping as AffinityToolMapping, type index_ContactLocator as ContactLocator, type index_JsonSchema as JsonSchema, type index_JsonSchemaType as JsonSchemaType, type index_LinkLocator as LinkLocator, type index_MutationToolData as MutationToolData, type index_ResolvedTarget as ResolvedTarget, type index_ToolBaseResult as ToolBaseResult, type index_ToolDefinitionRegistry as ToolDefinitionRegistry, type index_ToolEntityKind as ToolEntityKind, type index_ToolEntityRef as ToolEntityRef, type index_ToolFailure as ToolFailure, type index_ToolInputDescriptions as ToolInputDescriptions, type index_ToolListItem as ToolListItem, type index_ToolNeedsClarification as ToolNeedsClarification, type index_ToolNextStepHint as ToolNextStepHint, type index_ToolOutcomeKind as ToolOutcomeKind, type index_ToolOutputDescription as ToolOutputDescription, type index_ToolResult as ToolResult, type index_ToolSideEffects as ToolSideEffects, type index_ToolSuccess as ToolSuccess, type index_ToolWarning as ToolWarning, index_affinityToolMappings as affinityToolMappings, index_affinityTools as affinityTools, index_arraySchema as arraySchema, index_booleanSchema as booleanSchema, index_defineAffinityTool as defineAffinityTool, index_enumSchema as enumSchema, index_getAffinityToolByName as getAffinityToolByName, index_inspectAffinityItemTool as inspectAffinityItemTool, index_inspectAffinityItemToolHandler as inspectAffinityItemToolHandler, index_inspectAffinityItemToolName as inspectAffinityItemToolName, index_integerSchema as integerSchema, index_listAffinityToolDefinitions as listAffinityToolDefinitions, index_literalSchema as literalSchema, index_manageAttributeTool as manageAttributeTool, index_manageAttributeToolHandler as manageAttributeToolHandler, index_manageAttributeToolName as manageAttributeToolName, index_manageCommitmentTool as manageCommitmentTool, index_manageCommitmentToolHandler as manageCommitmentToolHandler, index_manageCommitmentToolName as manageCommitmentToolName, index_manageContactTool as manageContactTool, index_manageContactToolHandler as manageContactToolHandler, index_manageContactToolName as manageContactToolName, index_manageDateAnchorTool as manageDateAnchorTool, index_manageDateAnchorToolHandler as manageDateAnchorToolHandler, index_manageDateAnchorToolName as manageDateAnchorToolName, index_manageDuplicateDismissalTool as manageDuplicateDismissalTool, index_manageDuplicateDismissalToolHandler as manageDuplicateDismissalToolHandler, index_manageDuplicateDismissalToolName as manageDuplicateDismissalToolName, index_manageIdentityTool as manageIdentityTool, index_manageIdentityToolHandler as manageIdentityToolHandler, index_manageIdentityToolName as manageIdentityToolName, index_manageRelationshipTool as manageRelationshipTool, index_manageRelationshipToolHandler as manageRelationshipToolHandler, index_manageRelationshipToolName as manageRelationshipToolName, index_mapErrorToToolFailure as mapErrorToToolFailure, index_mergeContactsTool as mergeContactsTool, index_mergeContactsToolHandler as mergeContactsToolHandler, index_mergeContactsToolName as mergeContactsToolName, index_mutationToolResult as mutationToolResult, index_nullableStringSchema as nullableStringSchema, index_numberSchema as numberSchema, index_objectSchema as objectSchema, index_oneOfSchema as oneOfSchema, index_recordEventTool as recordEventTool, index_recordEventToolHandler as recordEventToolHandler, index_recordEventToolName as recordEventToolName, index_resolveContactLocator as resolveContactLocator, index_resolveLinkLocator as resolveLinkLocator, index_reviewAffinityTool as reviewAffinityTool, index_reviewAffinityToolHandler as reviewAffinityToolHandler, index_reviewAffinityToolName as reviewAffinityToolName, index_searchAffinityTool as searchAffinityTool, index_searchAffinityToolHandler as searchAffinityToolHandler, index_searchAffinityToolName as searchAffinityToolName, index_stringSchema as stringSchema, index_summarizeCount as summarizeCount, index_toAttributeEntityRef as toAttributeEntityRef, index_toAttributeListToolItem as toAttributeListToolItem, index_toContactEntityRef as toContactEntityRef, index_toContactListToolItem as toContactListToolItem, index_toEventEntityRef as toEventEntityRef, index_toEventListToolItem as toEventListToolItem, index_toIdentityEntityRef as toIdentityEntityRef, index_toIdentityListToolItem as toIdentityListToolItem, index_toLinkEntityRef as toLinkEntityRef, index_toLinkListToolItem as toLinkListToolItem, index_toMutationRefEntity as toMutationRefEntity, index_toReceiptEntityRefs as toReceiptEntityRefs, index_toolFailure as toolFailure, index_toolNeedsClarification as toolNeedsClarification, index_toolNoOp as toolNoOp, index_toolSuccess as toolSuccess, index_toolWarning as toolWarning, index_withToolHandling as withToolHandling };
+  export { type index_AffinityToolDefinition as AffinityToolDefinition, type index_AffinityToolMapping as AffinityToolMapping, type index_ContactLocator as ContactLocator, type index_JsonSchema as JsonSchema, type index_JsonSchemaType as JsonSchemaType, type index_LinkLocator as LinkLocator, type index_ManageEventToolInput as ManageEventToolInput, type index_ManageEventToolResult as ManageEventToolResult, type index_MutationToolData as MutationToolData, type index_ResolvedTarget as ResolvedTarget, type index_ToolBaseResult as ToolBaseResult, type index_ToolDefinitionRegistry as ToolDefinitionRegistry, type index_ToolEntityKind as ToolEntityKind, type index_ToolEntityRef as ToolEntityRef, type index_ToolFailure as ToolFailure, type index_ToolInputDescriptions as ToolInputDescriptions, type index_ToolListItem as ToolListItem, type index_ToolNeedsClarification as ToolNeedsClarification, type index_ToolNextStepHint as ToolNextStepHint, type index_ToolOutcomeKind as ToolOutcomeKind, type index_ToolOutputDescription as ToolOutputDescription, type index_ToolResult as ToolResult, type index_ToolSideEffects as ToolSideEffects, type index_ToolSuccess as ToolSuccess, type index_ToolWarning as ToolWarning, index_affinityToolMappings as affinityToolMappings, index_affinityTools as affinityTools, index_arraySchema as arraySchema, index_booleanSchema as booleanSchema, index_defineAffinityTool as defineAffinityTool, index_enumSchema as enumSchema, index_getAffinityToolByName as getAffinityToolByName, index_inspectAffinityItemTool as inspectAffinityItemTool, index_inspectAffinityItemToolHandler as inspectAffinityItemToolHandler, index_inspectAffinityItemToolName as inspectAffinityItemToolName, index_integerSchema as integerSchema, index_listAffinityToolDefinitions as listAffinityToolDefinitions, index_literalSchema as literalSchema, index_manageAttributeTool as manageAttributeTool, index_manageAttributeToolHandler as manageAttributeToolHandler, index_manageAttributeToolName as manageAttributeToolName, index_manageCommitmentTool as manageCommitmentTool, index_manageCommitmentToolHandler as manageCommitmentToolHandler, index_manageCommitmentToolName as manageCommitmentToolName, index_manageContactTool as manageContactTool, index_manageContactToolHandler as manageContactToolHandler, index_manageContactToolName as manageContactToolName, index_manageDateAnchorTool as manageDateAnchorTool, index_manageDateAnchorToolHandler as manageDateAnchorToolHandler, index_manageDateAnchorToolName as manageDateAnchorToolName, index_manageDuplicateDismissalTool as manageDuplicateDismissalTool, index_manageDuplicateDismissalToolHandler as manageDuplicateDismissalToolHandler, index_manageDuplicateDismissalToolName as manageDuplicateDismissalToolName, index_manageEventTool as manageEventTool, index_manageEventToolHandler as manageEventToolHandler, index_manageEventToolName as manageEventToolName, index_manageIdentityTool as manageIdentityTool, index_manageIdentityToolHandler as manageIdentityToolHandler, index_manageIdentityToolName as manageIdentityToolName, index_manageRelationshipTool as manageRelationshipTool, index_manageRelationshipToolHandler as manageRelationshipToolHandler, index_manageRelationshipToolName as manageRelationshipToolName, index_mapErrorToToolFailure as mapErrorToToolFailure, index_mergeContactsTool as mergeContactsTool, index_mergeContactsToolHandler as mergeContactsToolHandler, index_mergeContactsToolName as mergeContactsToolName, index_mutationToolResult as mutationToolResult, index_nullableStringSchema as nullableStringSchema, index_numberSchema as numberSchema, index_objectSchema as objectSchema, index_oneOfSchema as oneOfSchema, index_parseTimeInput as parseTimeInput, index_recordEventTool as recordEventTool, index_recordEventToolHandler as recordEventToolHandler, index_recordEventToolName as recordEventToolName, index_resolveContactLocator as resolveContactLocator, index_resolveLinkLocator as resolveLinkLocator, index_reviewAffinityTool as reviewAffinityTool, index_reviewAffinityToolHandler as reviewAffinityToolHandler, index_reviewAffinityToolName as reviewAffinityToolName, index_searchAffinityTool as searchAffinityTool, index_searchAffinityToolHandler as searchAffinityToolHandler, index_searchAffinityToolName as searchAffinityToolName, index_stringSchema as stringSchema, index_summarizeCount as summarizeCount, index_toAttributeEntityRef as toAttributeEntityRef, index_toAttributeListToolItem as toAttributeListToolItem, index_toContactEntityRef as toContactEntityRef, index_toContactListToolItem as toContactListToolItem, index_toEventEntityRef as toEventEntityRef, index_toEventListToolItem as toEventListToolItem, index_toIdentityEntityRef as toIdentityEntityRef, index_toIdentityListToolItem as toIdentityListToolItem, index_toLinkEntityRef as toLinkEntityRef, index_toLinkListToolItem as toLinkListToolItem, index_toMutationRefEntity as toMutationRefEntity, index_toReceiptEntityRefs as toReceiptEntityRefs, index_toolFailure as toolFailure, index_toolNeedsClarification as toolNeedsClarification, index_toolNoOp as toolNoOp, index_toolSuccess as toolSuccess, index_toolWarning as toolWarning, index_withToolHandling as withToolHandling };
 }
 
 declare function addIdentity(db: AffinityDb, contactId: number, input: AddIdentityInput): IdentityMutationReceipt;
@@ -1666,6 +2442,8 @@ declare function unsetAttribute(db: AffinityDb, target: AttributeTarget, name: s
 declare const write_addDateAnchor: typeof addDateAnchor;
 declare const write_addIdentity: typeof addIdentity;
 declare const write_createContact: typeof createContact;
+declare const write_deleteContact: typeof deleteContact;
+declare const write_deleteEvent: typeof deleteEvent;
 declare const write_dismissDuplicate: typeof dismissDuplicate;
 declare const write_mergeContacts: typeof mergeContacts;
 declare const write_overrideLinkState: typeof overrideLinkState;
@@ -1682,6 +2460,7 @@ declare const write_resolveCommitment: typeof resolveCommitment;
 declare const write_reviseBond: typeof reviseBond;
 declare const write_reviseContact: typeof reviseContact;
 declare const write_reviseDateAnchor: typeof reviseDateAnchor;
+declare const write_reviseEvent: typeof reviseEvent;
 declare const write_reviseIdentity: typeof reviseIdentity;
 declare const write_seedSocialLink: typeof seedSocialLink;
 declare const write_setAttribute: typeof setAttribute;
@@ -1691,7 +2470,7 @@ declare const write_undismissDuplicate: typeof undismissDuplicate;
 declare const write_unsetAttribute: typeof unsetAttribute;
 declare const write_verifyIdentity: typeof verifyIdentity;
 declare namespace write {
-  export { write_addDateAnchor as addDateAnchor, write_addIdentity as addIdentity, write_createContact as createContact, write_dismissDuplicate as dismissDuplicate, write_mergeContacts as mergeContacts, write_overrideLinkState as overrideLinkState, write_recordCommitment as recordCommitment, write_recordInteraction as recordInteraction, write_recordMilestone as recordMilestone, write_recordObservation as recordObservation, write_recordTransaction as recordTransaction, write_removeDateAnchor as removeDateAnchor, write_removeIdentity as removeIdentity, write_removeStructuralTie as removeStructuralTie, write_replaceAttributes as replaceAttributes, write_resolveCommitment as resolveCommitment, write_reviseBond as reviseBond, write_reviseContact as reviseContact, write_reviseDateAnchor as reviseDateAnchor, write_reviseIdentity as reviseIdentity, write_seedSocialLink as seedSocialLink, write_setAttribute as setAttribute, write_setContactLifecycle as setContactLifecycle, write_setStructuralTie as setStructuralTie, write_undismissDuplicate as undismissDuplicate, write_unsetAttribute as unsetAttribute, write_verifyIdentity as verifyIdentity };
+  export { write_addDateAnchor as addDateAnchor, write_addIdentity as addIdentity, write_createContact as createContact, write_deleteContact as deleteContact, write_deleteEvent as deleteEvent, write_dismissDuplicate as dismissDuplicate, write_mergeContacts as mergeContacts, write_overrideLinkState as overrideLinkState, write_recordCommitment as recordCommitment, write_recordInteraction as recordInteraction, write_recordMilestone as recordMilestone, write_recordObservation as recordObservation, write_recordTransaction as recordTransaction, write_removeDateAnchor as removeDateAnchor, write_removeIdentity as removeIdentity, write_removeStructuralTie as removeStructuralTie, write_replaceAttributes as replaceAttributes, write_resolveCommitment as resolveCommitment, write_reviseBond as reviseBond, write_reviseContact as reviseContact, write_reviseDateAnchor as reviseDateAnchor, write_reviseEvent as reviseEvent, write_reviseIdentity as reviseIdentity, write_seedSocialLink as seedSocialLink, write_setAttribute as setAttribute, write_setContactLifecycle as setContactLifecycle, write_setStructuralTie as setStructuralTie, write_undismissDuplicate as undismissDuplicate, write_unsetAttribute as unsetAttribute, write_verifyIdentity as verifyIdentity };
 }
 
 export { AffinityConflictError, AffinityError, type AffinityErrorCode, AffinityInvariantError, AffinityMergeError, AffinityNotFoundError, type AffinitySkill, type AffinitySkillRegistry, type AffinitySoul, type AffinitySoulTrait, AffinityStateError, AffinityValidationError, affinitySkills, affinitySoul, affinitySoulEssence, affinitySoulTraits, bootstrapAndColdStartSkill, captureTransactionsAndCommercialEventsSkill, defineAffinitySkill, errors, getAffinitySkillByName, identifyAndLocateContactsSkill, importHistoryWithoutFakingEvidenceSkill, initAffinityTables, isAffinityError, listAffinitySkills, managePromisesAndAgreementsSkill, manageRecurringDatesAndRemindersSkill, modelStructureOrgsAndHouseholdsSkill, read, reconcileDuplicatesAndMergeSafelySkill, recordDirectEvidenceWellSkill, recordObservationsAndReferralsSkill, renderAffinitySoulPromptFoundation, reviewRadarProgressionAndGraphSkill, index$1 as skills, soul, index as tools, types, write };