@hraness/message-like-me 0.8.0

package/dist/ensoul-source-v1.d.ts

@@ -0,0 +1,121 @@
+import type { ContactMetrics, CorpusMessage, CorpusReactionFact } from "./types.ts";
+export declare const ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY: "ensoul.source-packet.v1";
+export declare const ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID: "ensoul.messages-source.v1";
+export declare const ENSOUL_DIGEST_CANONICALIZATION: "JCS-RFC8785";
+export declare const DEFAULT_ENSOUL_MESSAGES_EXAMPLE_LIMIT = 24;
+export declare const MAX_ENSOUL_MESSAGES_EXAMPLE_LIMIT = 50;
+export type EnsoulMessagesSubjectRole = "owner" | "contact";
+export type EnsoulAuthorRole = "subject" | "counterpart";
+export type EnsoulMessagesSourceRecordV1 = Readonly<{
+    id: `message:sha256:${string}`;
+    digest: `sha256:${string}`;
+    kind: "message";
+    occurredAt: string;
+    authorRole: EnsoulAuthorRole;
+    contentRole: "original";
+    authorshipConfidence: "strong";
+    sentStatus: "sent" | "received";
+    visibility: "private";
+    sourceClass: "private_capture";
+    content: Readonly<{
+        text: string;
+        truncated: boolean;
+    }>;
+    provenance: Readonly<{
+        provider: "message-like-me";
+        sourceId: string;
+        runId: `response:sha256:${string}`;
+        operation: "ensoul prepare";
+        policyVersion: typeof ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID;
+        contentSha256: string;
+    }>;
+}>;
+export type EnsoulMessagesSourcePacketV1 = Readonly<{
+    schemaVersion: typeof ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY;
+    digestCanonicalization: typeof ENSOUL_DIGEST_CANONICALIZATION;
+    packetId: `message-like-me:sha256:${string}`;
+    generatedAt: string;
+    subject: Readonly<{
+        localId: string;
+        kind: EnsoulMessagesSubjectRole;
+        identityBasis: "local Message Like Me installation owner" | "exact AddressBook-backed direct person scope";
+    }>;
+    scope: Readonly<{
+        adapter: "message-like-me";
+        payloadSchema: typeof ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID;
+        asOf: string;
+        sourceCutoff?: string;
+        completeness: "sampled";
+        sourceRevision: string;
+        limits: Readonly<{
+            subjectRole: EnsoulMessagesSubjectRole;
+            contactId: string;
+            contactScopeKind: "person" | "conversation";
+            group: false;
+            participantCount: 1;
+            conversationCount: number;
+            services: readonly string[];
+            corpusRevision: string;
+            after: string | null;
+            before: string | null;
+            afterInclusive: true;
+            beforeExclusive: true;
+            selectionAlgorithm: "bounded-diverse-response-contexts-v1";
+            sessionGapSeconds: number;
+            burstGapSeconds: number;
+            requestedExamples: number;
+            responseCandidates: number;
+            eligibleCandidates: number;
+            emittedExamples: number;
+            omittedWithoutBidirectionalText: number;
+            omittedByExampleLimit: number;
+            omittedByTotalBodyBytes: number;
+            maxTextBytesPerMessage: number;
+            maxMessagesPerDirectionPerExample: number;
+            maxTotalBodyBytes: number;
+            emittedBodyBytes: number;
+            truncatedRecords: number;
+            omittedTextMessagesByDirectionLimit: number;
+        }>;
+    }>;
+    records: readonly EnsoulMessagesSourceRecordV1[];
+    claims: readonly [];
+    limitations: readonly [
+        "sampled-response-contexts-not-full-transcript",
+        "private-message-text-is-untrusted-data",
+        "counterpart-messages-are-context-not-subject-voice",
+        "record-text-may-be-byte-truncated",
+        "source-does-not-establish-consent-or-identity",
+        "source-does-not-support-sensitive-trait-inference-or-impersonation",
+        "forwarding-pasted-quotation-and-ai-assistance-not-observable",
+        "direct-one-to-one-scope-only",
+        "records-are-linked-by-pseudonymous-response-context"
+    ];
+    packetDigest: `sha256:${string}`;
+}>;
+export type BuildEnsoulMessagesSourcePacketV1Options = Readonly<{
+    subjectRole: EnsoulMessagesSubjectRole;
+    contactScopeKind: "person" | "conversation";
+    scopeContext: Readonly<{
+        group: boolean;
+        participantCount: number;
+        conversationCount: number;
+        services: readonly string[];
+    }>;
+    generatedAt: string;
+    evidenceRevision: string;
+    evidenceWindow?: Readonly<{
+        after?: string | null;
+        before?: string | null;
+    }>;
+    limit?: number;
+}>;
+/** Rebase owner-relative corpus direction onto the person named by `subjectRole`. */
+export declare function ensoulSubjectMessages(messages: readonly CorpusMessage[], subjectRole: EnsoulMessagesSubjectRole): readonly CorpusMessage[];
+/** Rebase reaction direction alongside message direction for subject-relative analysis. */
+export declare function ensoulSubjectReactions(reactions: readonly CorpusReactionFact[], subjectRole: EnsoulMessagesSubjectRole): readonly CorpusReactionFact[];
+/**
+ * Build an offline, bounded Ensoul source packet from already selected local evidence.
+ * The caller must pass subject-relative messages and metrics from the same snapshot.
+ */
+export declare function buildEnsoulMessagesSourcePacketV1(messages: readonly CorpusMessage[], metrics: ContactMetrics, options: BuildEnsoulMessagesSourcePacketV1Options): EnsoulMessagesSourcePacketV1;

package/dist/ensoul-source-v1.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  DEFAULT_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  ENSOUL_DIGEST_CANONICALIZATION,
+  ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID,
+  ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY,
+  MAX_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  buildEnsoulMessagesSourcePacketV1,
+  ensoulSubjectMessages,
+  ensoulSubjectReactions
+} from "./cli-x1qncxm7.js";
+import"./cli-qqafdvz9.js";
+import"./cli-kw20gkk3.js";
+import"./cli-ththzwja.js";
+export {
+  ensoulSubjectReactions,
+  ensoulSubjectMessages,
+  buildEnsoulMessagesSourcePacketV1,
+  MAX_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY,
+  ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID,
+  ENSOUL_DIGEST_CANONICALIZATION,
+  DEFAULT_ENSOUL_MESSAGES_EXAMPLE_LIMIT
+};

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./ensoul-source-v1.js";
+export { canonicalJson, sha256 } from "./canonical-json.js";

package/dist/index.js

@@ -0,0 +1,47 @@
+// @bun
+import {
+  CONTACTS_SCHEMA_VERSION,
+  CORPUS_SCHEMA_VERSION,
+  DEFAULT_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  ENSOUL_DIGEST_CANONICALIZATION,
+  ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID,
+  ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY,
+  EVALUATION_PACKET_SCHEMA_VERSION,
+  LEGACY_PROFILE_SCHEMA_VERSION,
+  MAX_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  MESSAGE_BUNDLE_SCHEMA_VERSION,
+  MESSAGE_BUNDLE_SCHEMA_VERSIONS,
+  METRICS_SCHEMA_VERSION,
+  PROFILE_SCHEMA_VERSION,
+  STUDY_PACKET_SCHEMA_VERSION,
+  buildEnsoulMessagesSourcePacketV1,
+  ensoulSubjectMessages,
+  ensoulSubjectReactions
+} from "./cli-x1qncxm7.js";
+import"./cli-qqafdvz9.js";
+import"./cli-kw20gkk3.js";
+import {
+  canonicalJson,
+  sha256
+} from "./cli-ththzwja.js";
+export {
+  sha256,
+  ensoulSubjectReactions,
+  ensoulSubjectMessages,
+  canonicalJson,
+  buildEnsoulMessagesSourcePacketV1,
+  STUDY_PACKET_SCHEMA_VERSION,
+  PROFILE_SCHEMA_VERSION,
+  METRICS_SCHEMA_VERSION,
+  MESSAGE_BUNDLE_SCHEMA_VERSIONS,
+  MESSAGE_BUNDLE_SCHEMA_VERSION,
+  MAX_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  LEGACY_PROFILE_SCHEMA_VERSION,
+  EVALUATION_PACKET_SCHEMA_VERSION,
+  ENSOUL_SOURCE_PACKET_V1_SCHEMA_IDENTITY,
+  ENSOUL_MESSAGES_SOURCE_V1_ADAPTER_ID,
+  ENSOUL_DIGEST_CANONICALIZATION,
+  DEFAULT_ENSOUL_MESSAGES_EXAMPLE_LIMIT,
+  CORPUS_SCHEMA_VERSION,
+  CONTACTS_SCHEMA_VERSION
+};

package/dist/message-bundle-v1-identity.d.ts

@@ -0,0 +1,2 @@
+/** Internal identity shared by the public wire contract and corpus API. */
+export declare const MESSAGE_BUNDLE_V1_SCHEMA_IDENTITY: 1;

package/dist/message-bundle-v1.d.ts

@@ -0,0 +1,205 @@
+/** Immutable wire-format identity for the local message bundle contract. */
+export declare const LOCAL_MESSAGE_BUNDLE_V1_SCHEMA_VERSION: 1;
+export declare const LOCAL_MESSAGE_BUNDLE_V1_FORMAT: "message-like-me.local-message-bundle";
+export declare const LOCAL_MESSAGE_BUNDLE_V1_SOURCE_ID: "beeper-local";
+export declare const LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION: "1.1.0";
+export declare const LOCAL_MESSAGE_BUNDLE_V1_PROVIDER_ID: "beeper";
+/**
+ * Source-transform versions whose semantic output Message Like Me v1 accepts.
+ * A producer package version may change without changing this transform version.
+ */
+export declare const LOCAL_MESSAGE_BUNDLE_V1_SUPPORTED_SOURCE_TRANSFORM_VERSIONS: readonly ["1.1.0"];
+export declare const LOCAL_MESSAGE_BUNDLE_V1_LIMITS: Readonly<{
+    readonly manifestBytes: number;
+    readonly records: 500000;
+    readonly recordBytes: number;
+    readonly totalBytes: number;
+    readonly accounts: 128;
+    readonly identifierBytes: 1024;
+    readonly shortTextBytes: number;
+    readonly bodyBytes: number;
+    readonly mimeTypeBytes: 256;
+    readonly participantsPerConversation: 10000;
+    readonly attachmentsPerMessage: 256;
+    readonly warnings: 128;
+}>;
+export declare const LOCAL_MESSAGE_BUNDLE_V1_ARTIFACTS: readonly [Readonly<{
+    path: "accounts.ndjson";
+    kind: "account";
+}>, Readonly<{
+    path: "participants.ndjson";
+    kind: "participant";
+}>, Readonly<{
+    path: "conversations.ndjson";
+    kind: "conversation";
+}>, Readonly<{
+    path: "messages.ndjson";
+    kind: "message";
+}>, Readonly<{
+    path: "reactions.ndjson";
+    kind: "reaction";
+}>, Readonly<{
+    path: "tombstones.ndjson";
+    kind: "tombstone";
+}>];
+export type LocalMessageBundleV1RecordKind = typeof LOCAL_MESSAGE_BUNDLE_V1_ARTIFACTS[number]["kind"];
+export type LocalMessageBundleV1ArtifactPath = typeof LOCAL_MESSAGE_BUNDLE_V1_ARTIFACTS[number]["path"];
+export type LocalMessageBundleV1Provenance = Readonly<{
+    providerId: string;
+    providerRevision: string | null;
+    observedAt: string;
+    connectedAccountProviderId: string;
+}>;
+export type LocalMessageBundleV1CommonRecord = Readonly<{
+    schemaVersion: typeof LOCAL_MESSAGE_BUNDLE_V1_SCHEMA_VERSION;
+    kind: LocalMessageBundleV1RecordKind;
+    id: string;
+    accountId: string;
+    network: string;
+    provenance: LocalMessageBundleV1Provenance;
+}>;
+export type LocalMessageBundleV1AccountRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "account";
+    displayName: string | null;
+    handle: string | null;
+    selfParticipantId: string;
+}>;
+export type LocalMessageBundleV1ParticipantRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "participant";
+    displayName: string | null;
+    handle: string | null;
+    isSelf: boolean;
+}>;
+export type LocalMessageBundleV1ConversationRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "conversation";
+    type: "direct" | "group" | "channel" | "unknown";
+    title: string | null;
+    participantIds: readonly string[];
+    participantsComplete: boolean | null;
+    startedAt: string | null;
+    lastMessageAt: string | null;
+}>;
+export type LocalMessageBundleV1AttachmentRecord = Readonly<{
+    kind: "audio" | "document" | "image" | "link" | "sticker" | "video" | "unknown";
+    mimeType: string | null;
+    name: string | null;
+    sizeBytes: number | null;
+}>;
+export type LocalMessageBundleV1Reply = Readonly<{
+    messageId: string | null;
+    providerId: string;
+}>;
+export type LocalMessageBundleV1Edit = Readonly<{
+    kind: "in-place";
+    editedAt: string;
+    providerRevision: string;
+}> | Readonly<{
+    kind: "replacement";
+    replacesMessageId: string | null;
+    replacesProviderId: string;
+    editedAt: string;
+    providerRevision: string;
+}>;
+export type LocalMessageBundleV1Deletion = Readonly<{
+    state: "revoked" | "deleted-for-me" | "revoked-and-deleted-for-me";
+    observedAt: string;
+    providerRevision: string | null;
+}>;
+export type LocalMessageBundleV1MessageRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "message";
+    conversationId: string;
+    senderParticipantId: string | null;
+    direction: "incoming" | "outgoing" | "unknown";
+    sentAt: string;
+    sortKey: string;
+    body: string | null;
+    bodyTruncated: boolean | null;
+    replyTo: LocalMessageBundleV1Reply | null;
+    edit: LocalMessageBundleV1Edit | null;
+    deletion: LocalMessageBundleV1Deletion | null;
+    attachments: readonly LocalMessageBundleV1AttachmentRecord[];
+}>;
+export type LocalMessageBundleV1ReactionRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "reaction";
+    messageId: string | null;
+    messageProviderId: string;
+    participantId: string | null;
+    body: string;
+    reactedAt: string | null;
+    state: "active" | "removed";
+}>;
+export type LocalMessageBundleV1TombstoneRecord = LocalMessageBundleV1CommonRecord & Readonly<{
+    kind: "tombstone";
+    entityKind: "conversation" | "message" | "reaction";
+    entityId: string | null;
+    entityProviderId: string;
+    deletedAt: string;
+    scope: "remote" | "local" | "unknown";
+    providerRevision: string | null;
+}>;
+export type LocalMessageBundleV1Record = LocalMessageBundleV1AccountRecord | LocalMessageBundleV1ParticipantRecord | LocalMessageBundleV1ConversationRecord | LocalMessageBundleV1MessageRecord | LocalMessageBundleV1ReactionRecord | LocalMessageBundleV1TombstoneRecord;
+export type LocalMessageBundleV1RecordByKind = Readonly<{
+    account: LocalMessageBundleV1AccountRecord;
+    participant: LocalMessageBundleV1ParticipantRecord;
+    conversation: LocalMessageBundleV1ConversationRecord;
+    message: LocalMessageBundleV1MessageRecord;
+    reaction: LocalMessageBundleV1ReactionRecord;
+    tombstone: LocalMessageBundleV1TombstoneRecord;
+}>;
+export type LocalMessageBundleV1Artifact = Readonly<{
+    path: LocalMessageBundleV1ArtifactPath;
+    mediaType: "application/x-ndjson";
+    recordKind: LocalMessageBundleV1RecordKind;
+    records: number;
+    bytes: number;
+    sha256: string;
+}>;
+export type LocalMessageBundleV1ManifestProjection = Readonly<{
+    schemaVersion: typeof LOCAL_MESSAGE_BUNDLE_V1_SCHEMA_VERSION;
+    format: typeof LOCAL_MESSAGE_BUNDLE_V1_FORMAT;
+    source: Readonly<{
+        id: typeof LOCAL_MESSAGE_BUNDLE_V1_SOURCE_ID;
+        version: typeof LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION;
+    }>;
+    provider: Readonly<{
+        id: typeof LOCAL_MESSAGE_BUNDLE_V1_PROVIDER_ID;
+        version: string;
+    }>;
+    timestamps: Readonly<{
+        startedAt: string;
+        finishedAt: string;
+        createdAt: string;
+    }>;
+    completeness: Readonly<{
+        kind: "bounded-local" | "truncated" | "unknown";
+        reason: string | null;
+        observedFrom: string | null;
+        observedThrough: string | null;
+    }>;
+    warnings: readonly string[];
+    privacy: Readonly<{
+        classification: "private-local";
+        attachments: "metadata-only";
+        providerUrls: "excluded";
+        credentials: "excluded";
+    }>;
+    counts: Readonly<Record<LocalMessageBundleV1RecordKind, number>>;
+    artifacts: readonly LocalMessageBundleV1Artifact[];
+}>;
+export type LocalMessageBundleV1Manifest = LocalMessageBundleV1ManifestProjection & Readonly<{
+    integrity: Readonly<{
+        algorithm: "sha256";
+        bundleSha256: string;
+    }>;
+}>;
+/** Stable error category for callers that validate untrusted contract values. */
+export declare class MessageBundleV1ContractError extends TypeError {
+    readonly code: "message-bundle-v1-contract";
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare function isLocalMessageBundleV1SourceTransformVersion(value: unknown): value is typeof LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION;
+export declare function assertLocalMessageBundleV1SourceTransformVersion(value: unknown, label?: string): typeof LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION;
+export declare function parseLocalMessageBundleV1Record<Kind extends LocalMessageBundleV1RecordKind>(value: unknown, kind: Kind, label?: string): LocalMessageBundleV1RecordByKind[Kind];
+export declare function localMessageBundleV1ManifestProjection(manifest: LocalMessageBundleV1Manifest): LocalMessageBundleV1ManifestProjection;
+export declare function localMessageBundleV1BundleSha256(projection: LocalMessageBundleV1ManifestProjection): string;
+export declare function parseLocalMessageBundleV1Manifest(value: unknown): LocalMessageBundleV1Manifest;

package/dist/message-bundle-v1.js

@@ -0,0 +1,37 @@
+// @bun
+import {
+  LOCAL_MESSAGE_BUNDLE_V1_ARTIFACTS,
+  LOCAL_MESSAGE_BUNDLE_V1_FORMAT,
+  LOCAL_MESSAGE_BUNDLE_V1_LIMITS,
+  LOCAL_MESSAGE_BUNDLE_V1_PROVIDER_ID,
+  LOCAL_MESSAGE_BUNDLE_V1_SCHEMA_VERSION,
+  LOCAL_MESSAGE_BUNDLE_V1_SOURCE_ID,
+  LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION,
+  LOCAL_MESSAGE_BUNDLE_V1_SUPPORTED_SOURCE_TRANSFORM_VERSIONS,
+  MessageBundleV1ContractError,
+  assertLocalMessageBundleV1SourceTransformVersion,
+  isLocalMessageBundleV1SourceTransformVersion,
+  localMessageBundleV1BundleSha256,
+  localMessageBundleV1ManifestProjection,
+  parseLocalMessageBundleV1Manifest,
+  parseLocalMessageBundleV1Record
+} from "./cli-ry4128kz.js";
+import"./cli-qqafdvz9.js";
+import"./cli-ththzwja.js";
+export {
+  parseLocalMessageBundleV1Record,
+  parseLocalMessageBundleV1Manifest,
+  localMessageBundleV1ManifestProjection,
+  localMessageBundleV1BundleSha256,
+  isLocalMessageBundleV1SourceTransformVersion,
+  assertLocalMessageBundleV1SourceTransformVersion,
+  MessageBundleV1ContractError,
+  LOCAL_MESSAGE_BUNDLE_V1_SUPPORTED_SOURCE_TRANSFORM_VERSIONS,
+  LOCAL_MESSAGE_BUNDLE_V1_SOURCE_TRANSFORM_VERSION,
+  LOCAL_MESSAGE_BUNDLE_V1_SOURCE_ID,
+  LOCAL_MESSAGE_BUNDLE_V1_SCHEMA_VERSION,
+  LOCAL_MESSAGE_BUNDLE_V1_PROVIDER_ID,
+  LOCAL_MESSAGE_BUNDLE_V1_LIMITS,
+  LOCAL_MESSAGE_BUNDLE_V1_FORMAT,
+  LOCAL_MESSAGE_BUNDLE_V1_ARTIFACTS
+};

package/dist/message-bundle-v2-identity.d.ts

@@ -0,0 +1,2 @@
+/** Internal identity shared by the public WhatsApp wire contract and corpus API. */
+export declare const MESSAGE_BUNDLE_V2_SCHEMA_IDENTITY: 2;

package/dist/message-bundle-v2.d.ts

@@ -0,0 +1,215 @@
+/** Immutable wire-format identity for the local message bundle contract. */
+export declare const LOCAL_MESSAGE_BUNDLE_V2_SCHEMA_VERSION: 2;
+export declare const LOCAL_MESSAGE_BUNDLE_V2_FORMAT: "message-like-me.local-message-bundle";
+export declare const LOCAL_MESSAGE_BUNDLE_V2_SOURCE_ID: "wacli-local";
+export declare const LOCAL_MESSAGE_BUNDLE_V2_SOURCE_TRANSFORM_VERSION: "1.0.0";
+export declare const LOCAL_MESSAGE_BUNDLE_V2_PROVIDER_ID: "whatsapp";
+export declare const LOCAL_MESSAGE_BUNDLE_V2_PROVIDER_VERSION: "0.15.0";
+export declare const LOCAL_MESSAGE_BUNDLE_V2_NETWORK: "whatsapp";
+/**
+ * Source-transform versions whose semantic output Message Like Me v2 accepts.
+ * A producer package version may change without changing this transform version.
+ */
+export declare const LOCAL_MESSAGE_BUNDLE_V2_SUPPORTED_SOURCE_TRANSFORM_VERSIONS: readonly ["1.0.0"];
+export declare const LOCAL_MESSAGE_BUNDLE_V2_LIMITS: Readonly<{
+    readonly manifestBytes: number;
+    readonly records: 500000;
+    readonly recordBytes: number;
+    readonly totalBytes: number;
+    readonly accounts: 1;
+    readonly identifierBytes: 1024;
+    readonly shortTextBytes: number;
+    readonly bodyBytes: number;
+    readonly mimeTypeBytes: 256;
+    readonly participantsPerConversation: 10000;
+    readonly attachmentsPerMessage: 256;
+    readonly warnings: 128;
+}>;
+export declare const LOCAL_MESSAGE_BUNDLE_V2_ARTIFACTS: readonly [Readonly<{
+    path: "accounts.ndjson";
+    kind: "account";
+}>, Readonly<{
+    path: "participants.ndjson";
+    kind: "participant";
+}>, Readonly<{
+    path: "conversations.ndjson";
+    kind: "conversation";
+}>, Readonly<{
+    path: "messages.ndjson";
+    kind: "message";
+}>, Readonly<{
+    path: "reactions.ndjson";
+    kind: "reaction";
+}>, Readonly<{
+    path: "tombstones.ndjson";
+    kind: "tombstone";
+}>];
+export type LocalMessageBundleV2RecordKind = typeof LOCAL_MESSAGE_BUNDLE_V2_ARTIFACTS[number]["kind"];
+export type LocalMessageBundleV2ArtifactPath = typeof LOCAL_MESSAGE_BUNDLE_V2_ARTIFACTS[number]["path"];
+export type LocalMessageBundleV2Provenance = Readonly<{
+    providerId: string;
+    providerRevision: string | null;
+    observedAt: string;
+    connectedAccountProviderId: string;
+}>;
+export type LocalMessageBundleV2CommonRecord = Readonly<{
+    schemaVersion: typeof LOCAL_MESSAGE_BUNDLE_V2_SCHEMA_VERSION;
+    kind: LocalMessageBundleV2RecordKind;
+    id: string;
+    accountId: string;
+    network: typeof LOCAL_MESSAGE_BUNDLE_V2_NETWORK;
+    provenance: LocalMessageBundleV2Provenance;
+}>;
+export type LocalMessageBundleV2AccountRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "account";
+    displayName: string | null;
+    handle: string | null;
+    selfParticipantId: string;
+}>;
+export type LocalMessageBundleV2ParticipantRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "participant";
+    displayName: string | null;
+    handle: string | null;
+    isSelf: boolean;
+}>;
+export type LocalMessageBundleV2ConversationRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "conversation";
+    type: "direct" | "group";
+    title: string | null;
+    participantIds: readonly string[];
+    participantsComplete: boolean | null;
+    startedAt: string | null;
+    lastMessageAt: string | null;
+}>;
+export type LocalMessageBundleV2AttachmentRecord = Readonly<{
+    kind: "audio" | "document" | "image" | "link" | "sticker" | "video" | "unknown";
+    mimeType: string | null;
+    name: string | null;
+    sizeBytes: number | null;
+}>;
+export type LocalMessageBundleV2Reply = Readonly<{
+    messageId: string | null;
+    providerId: string;
+}>;
+export type LocalMessageBundleV2Edit = Readonly<{
+    kind: "in-place";
+    editedAt: string;
+    providerRevision: string;
+}> | Readonly<{
+    kind: "replacement";
+    replacesMessageId: string | null;
+    replacesProviderId: string;
+    editedAt: string;
+    providerRevision: string;
+}>;
+export type LocalMessageBundleV2Deletion = Readonly<{
+    state: "revoked" | "deleted-for-me" | "revoked-and-deleted-for-me";
+    observedAt: string;
+    providerRevision: string | null;
+}>;
+export type LocalMessageBundleV2MessageRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "message";
+    conversationId: string;
+    senderParticipantId: string | null;
+    direction: "incoming" | "outgoing" | "unknown";
+    sentAt: string;
+    sortKey: string;
+    body: string | null;
+    bodyTruncated: boolean | null;
+    replyTo: LocalMessageBundleV2Reply | null;
+    edit: LocalMessageBundleV2Edit | null;
+    deletion: LocalMessageBundleV2Deletion | null;
+    attachments: readonly LocalMessageBundleV2AttachmentRecord[];
+}>;
+export type LocalMessageBundleV2ReactionRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "reaction";
+    messageId: string | null;
+    messageProviderId: string;
+    participantId: string | null;
+    body: string;
+    reactedAt: string | null;
+    state: "active" | "removed";
+}>;
+export type LocalMessageBundleV2TombstoneRecord = LocalMessageBundleV2CommonRecord & Readonly<{
+    kind: "tombstone";
+    entityKind: "conversation" | "message" | "reaction";
+    entityId: string | null;
+    entityProviderId: string;
+    deletedAt: string;
+    scope: "remote" | "local" | "unknown";
+    providerRevision: string | null;
+}>;
+export type LocalMessageBundleV2Record = LocalMessageBundleV2AccountRecord | LocalMessageBundleV2ParticipantRecord | LocalMessageBundleV2ConversationRecord | LocalMessageBundleV2MessageRecord | LocalMessageBundleV2ReactionRecord | LocalMessageBundleV2TombstoneRecord;
+export type LocalMessageBundleV2RecordByKind = Readonly<{
+    account: LocalMessageBundleV2AccountRecord;
+    participant: LocalMessageBundleV2ParticipantRecord;
+    conversation: LocalMessageBundleV2ConversationRecord;
+    message: LocalMessageBundleV2MessageRecord;
+    reaction: LocalMessageBundleV2ReactionRecord;
+    tombstone: LocalMessageBundleV2TombstoneRecord;
+}>;
+export type LocalMessageBundleV2WhatsAppJidKind = "user" | "lid" | "group";
+export type LocalMessageBundleV2WhatsAppJid = Readonly<{
+    jid: string;
+    kind: LocalMessageBundleV2WhatsAppJidKind;
+    e164: string | null;
+}>;
+export type LocalMessageBundleV2Artifact = Readonly<{
+    path: LocalMessageBundleV2ArtifactPath;
+    mediaType: "application/x-ndjson";
+    recordKind: LocalMessageBundleV2RecordKind;
+    records: number;
+    bytes: number;
+    sha256: string;
+}>;
+export type LocalMessageBundleV2ManifestProjection = Readonly<{
+    schemaVersion: typeof LOCAL_MESSAGE_BUNDLE_V2_SCHEMA_VERSION;
+    format: typeof LOCAL_MESSAGE_BUNDLE_V2_FORMAT;
+    source: Readonly<{
+        id: typeof LOCAL_MESSAGE_BUNDLE_V2_SOURCE_ID;
+        version: typeof LOCAL_MESSAGE_BUNDLE_V2_SOURCE_TRANSFORM_VERSION;
+    }>;
+    provider: Readonly<{
+        id: typeof LOCAL_MESSAGE_BUNDLE_V2_PROVIDER_ID;
+        version: typeof LOCAL_MESSAGE_BUNDLE_V2_PROVIDER_VERSION;
+    }>;
+    timestamps: Readonly<{
+        startedAt: string;
+        finishedAt: string;
+        createdAt: string;
+    }>;
+    completeness: Readonly<{
+        kind: "bounded-local" | "truncated" | "unknown";
+        reason: string | null;
+        observedFrom: string | null;
+        observedThrough: string | null;
+    }>;
+    warnings: readonly string[];
+    privacy: Readonly<{
+        classification: "private-local";
+        attachments: "metadata-only";
+        providerUrls: "excluded";
+        credentials: "excluded";
+    }>;
+    counts: Readonly<Record<LocalMessageBundleV2RecordKind, number>>;
+    artifacts: readonly LocalMessageBundleV2Artifact[];
+}>;
+export type LocalMessageBundleV2Manifest = LocalMessageBundleV2ManifestProjection & Readonly<{
+    integrity: Readonly<{
+        algorithm: "sha256";
+        bundleSha256: string;
+    }>;
+}>;
+/** Stable error category for callers that validate untrusted contract values. */
+export declare class MessageBundleV2ContractError extends TypeError {
+    readonly code: "message-bundle-v2-contract";
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Parse one exact canonical WhatsApp JID admitted by the native bundle seam. */
+export declare function parseLocalMessageBundleV2WhatsAppJid(value: unknown, label?: string): LocalMessageBundleV2WhatsAppJid;
+export declare function isLocalMessageBundleV2SourceTransformVersion(value: unknown): value is typeof LOCAL_MESSAGE_BUNDLE_V2_SOURCE_TRANSFORM_VERSION;
+export declare function assertLocalMessageBundleV2SourceTransformVersion(value: unknown, label?: string): typeof LOCAL_MESSAGE_BUNDLE_V2_SOURCE_TRANSFORM_VERSION;
+export declare function parseLocalMessageBundleV2Record<Kind extends LocalMessageBundleV2RecordKind>(value: unknown, kind: Kind, label?: string): LocalMessageBundleV2RecordByKind[Kind];
+export declare function localMessageBundleV2ManifestProjection(manifest: LocalMessageBundleV2Manifest): LocalMessageBundleV2ManifestProjection;
+export declare function localMessageBundleV2BundleSha256(projection: LocalMessageBundleV2ManifestProjection): string;
+export declare function parseLocalMessageBundleV2Manifest(value: unknown): LocalMessageBundleV2Manifest;