@ghostpaw/affinity 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -167,6 +167,8 @@ interface EventParticipantView {
 
 /** Promise/agreement projection — CONCEPT.md CommitmentRecord. */
 interface CommitmentRecord {
+    dueAtIso?: string | null;
+    overdue?: boolean;
     eventId: number;
     type: EventType;
     summary: string;
@@ -193,6 +195,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;
@@ -212,11 +215,14 @@ type ContactJournalReadOptions = AffinityListReadOptions & {
 /** 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 +232,22 @@ interface ContactListItem {
     lastMeaningfulEventAt?: number | null;
 }
 
+/** 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;
+}
+
 /** One routing identity on a contact — CONCEPT.md IdentityRecord. */
 interface IdentityRecord {
     id: number;
@@ -296,6 +318,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[];
@@ -550,22 +587,6 @@ 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 {
     id: number;
@@ -643,6 +664,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;
@@ -717,6 +741,7 @@ type DismissalMutationReceipt = MutationReceipt<DismissedPairRef>;
 
 /** Maintenance radar row — CONCEPT.md RadarRecord. */
 interface RadarRecord {
+    reasons?: string[];
     linkId: number;
     contactId: number;
     driftPriority: number;
@@ -918,6 +943,41 @@ declare function recordTransaction(db: AffinityDb, input: RecordTransactionInput
 
 declare function resolveCommitment(db: AffinityDb, commitmentEventId: number, resolution: CommitmentResolutionKind, options?: ResolveCommitmentOptions): 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>[];
+};
+
+/** 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;
+    contacts: {
+        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 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;
@@ -938,7 +998,7 @@ declare const read_listRadar: typeof listRadar;
 declare const read_listUpcomingDates: typeof listUpcomingDates;
 declare const read_searchContacts: typeof searchContacts;
 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_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 };
 }
 
 interface AffinitySoulTrait {
@@ -1081,7 +1141,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" | "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 +1152,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;
 }
@@ -1206,6 +1269,12 @@ 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;
+/** Parse human time inputs using UTC days. Library mutations still accept numbers. */
+declare function parseTimeInput(value: number | string, field?: string, now?: number): number;
+
 type ContactLocator = {
     contactId: number;
 } | {
@@ -1232,7 +1301,7 @@ 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>;
@@ -1243,6 +1312,7 @@ type InspectAffinityItemToolInput = {
 } | {
     kind: "contact_profile";
     contact: ContactLocator;
+    recentEventsLimit?: number;
     topLinksLimit?: number;
 } | {
     kind: "link";
@@ -1260,10 +1330,16 @@ 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;
     created: MutationReceipt<TPrimary>["created"];
@@ -1273,7 +1349,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";
@@ -1298,8 +1374,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 +1387,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 +1425,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 +1449,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 +1503,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 +1524,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 +1557,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,8 +1567,27 @@ 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 RecordEventToolInput = {
     kind: "interaction";
@@ -1449,18 +1603,22 @@ type RecordEventToolInput = {
     input: 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";
 interface ReviewAffinityToolInput {
     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;
@@ -1486,8 +1644,53 @@ interface ReviewAffinityToolData {
     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<{
+    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;
@@ -1506,6 +1709,9 @@ interface SearchAffinityToolInput {
     query: string;
     kind?: ContactKind;
     lifecycleState?: ContactLifecycleState;
+    attribute?: string | string[];
+    tag?: string | string[];
+    includeLost?: boolean;
     includeOwner?: boolean;
     includeDormant?: boolean;
     limit?: number;
@@ -1517,12 +1723,305 @@ interface SearchAffinityToolData {
     count: number;
 }
 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<{
+    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>;
 
-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<{
+    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<{
+    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>)[];
+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<{
+    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<{
+    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>)[];
+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<{
+    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<{
+    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> | null;
 
 interface AffinityToolMapping {
     source: string;
@@ -1614,6 +2113,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 +2146,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_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_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 +2166,7 @@ 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_dismissDuplicate: typeof dismissDuplicate;
 declare const write_mergeContacts: typeof mergeContacts;
 declare const write_overrideLinkState: typeof overrideLinkState;
@@ -1691,7 +2192,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_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 { 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 };