@antiphony/shared 0.3.0 → 0.5.0

package/dist/esm/types/audio.d.ts

@@ -3,11 +3,6 @@ import { z } from 'zod';
 /**
  * Antiphony canonical audio-post contract (`dev.antiphony.*`).
  *
- * This is the NEW data model from `specs/antiphony-data-model.md`, added
- * ADDITIVELY alongside the legacy `PromptRecord`/`ReplyRecord` (Stream 1).
- * Nothing here touches the old shapes; Vox Pop keeps running on them until the
- * Stream 4 migration deletes the legacy schemas + `com.voxpop.*` lexicons.
- *
  * Mirrors the lexicons in `lexicons/dev/antiphony/`. Key model decisions:
  *  - ONE post collection; `reply` presence discriminates prompt-vs-reply.
  *  - The audio is a standard `embed.audio`; transcript is platform enrichment
@@ -85,20 +80,30 @@ type ReplyRef = z.infer<typeof ReplyRefSchema>;
  */
 declare const AudioEmbedSchema: z.ZodObject<{
     $type: z.ZodLiteral<"dev.antiphony.embed.audio">;
-    /** The audio bytes as a content-addressed storage ref (CID/path). */
+    /** The audio bytes as a content-addressed blob ref (`ref.$link` = CID). */
     audio: z.ZodObject<{
         $type: z.ZodLiteral<"blob">;
-        ref: z.ZodString;
+        ref: z.ZodObject<{
+            $link: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            $link: string;
+        }, {
+            $link: string;
+        }>;
         mimeType: z.ZodString;
         size: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         $type: "blob";
-        ref: string;
+        ref: {
+            $link: string;
+        };
         mimeType: string;
         size: number;
     }, {
         $type: "blob";
-        ref: string;
+        ref: {
+            $link: string;
+        };
         mimeType: string;
         size: number;
     }>;
@@ -112,24 +117,28 @@ declare const AudioEmbedSchema: z.ZodObject<{
     $type: "dev.antiphony.embed.audio";
     audio: {
         $type: "blob";
-        ref: string;
+        ref: {
+            $link: string;
+        };
         mimeType: string;
         size: number;
     };
+    waveform?: number[] | undefined;
     durationMs?: number | undefined;
     alt?: string | undefined;
-    waveform?: number[] | undefined;
 }, {
     $type: "dev.antiphony.embed.audio";
     audio: {
         $type: "blob";
-        ref: string;
+        ref: {
+            $link: string;
+        };
         mimeType: string;
         size: number;
     };
+    waveform?: number[] | undefined;
     durationMs?: number | undefined;
     alt?: string | undefined;
-    waveform?: number[] | undefined;
 }>;
 type AudioEmbed = z.infer<typeof AudioEmbedSchema>;
 /**
@@ -140,21 +149,21 @@ declare const TranscriptSegmentSchema: z.ZodEffects<z.ZodObject<{
     endMs: z.ZodNumber;
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    text: string;
     startMs: number;
     endMs: number;
-}, {
     text: string;
+}, {
     startMs: number;
     endMs: number;
-}>, {
     text: string;
+}>, {
     startMs: number;
     endMs: number;
-}, {
     text: string;
+}, {
     startMs: number;
     endMs: number;
+    text: string;
 }>;
 type TranscriptSegment = z.infer<typeof TranscriptSegmentSchema>;
 /**
@@ -168,35 +177,35 @@ declare const TimedTranscriptSchema: z.ZodObject<{
         endMs: z.ZodNumber;
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        text: string;
         startMs: number;
         endMs: number;
-    }, {
         text: string;
+    }, {
         startMs: number;
         endMs: number;
-    }>, {
         text: string;
+    }>, {
         startMs: number;
         endMs: number;
-    }, {
         text: string;
+    }, {
         startMs: number;
         endMs: number;
+        text: string;
     }>, "many">;
     text: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     segments: {
-        text: string;
         startMs: number;
         endMs: number;
+        text: string;
     }[];
     text?: string | undefined;
 }, {
     segments: {
-        text: string;
         startMs: number;
         endMs: number;
+        text: string;
     }[];
     text?: string | undefined;
 }>;
@@ -208,6 +217,18 @@ type TimedTranscript = z.infer<typeof TimedTranscriptSchema>;
  */
 declare const AudioEmbedViewSchema: z.ZodObject<{
     $type: z.ZodLiteral<"dev.antiphony.embed.audio#view">;
+    /**
+     * `url`, `durationMs` and `waveform` are RESOLVED, not copied: once
+     * processing has produced an audio variant they describe that variant
+     * rather than the bytes the client uploaded. They always agree with one
+     * another — a duration and a set of peaks are only meaningful against the
+     * audio `url` actually points at.
+     *
+     * A client that stored `durationMs` at upload time should therefore expect
+     * it to change (trim removes leading/trailing silence), and should render
+     * these three as a set rather than caching them independently. The record's
+     * originals are immutable and unaffected; this is a read-time resolution.
+     */
     url: z.ZodString;
     durationMs: z.ZodOptional<z.ZodNumber>;
     alt: z.ZodOptional<z.ZodString>;
@@ -219,66 +240,103 @@ declare const AudioEmbedViewSchema: z.ZodObject<{
             endMs: z.ZodNumber;
             text: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            text: string;
             startMs: number;
             endMs: number;
-        }, {
             text: string;
+        }, {
             startMs: number;
             endMs: number;
-        }>, {
             text: string;
+        }>, {
             startMs: number;
             endMs: number;
-        }, {
             text: string;
+        }, {
             startMs: number;
             endMs: number;
+            text: string;
         }>, "many">;
         text: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     }, {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     }>>;
+    /**
+     * Per-stage audio-processing status (denoise / trim / transcribe /
+     * waveform), when the app opted into processing. Absent otherwise. A
+     * `pending` stage means the client should poll (or re-render) for the
+     * result — including a stage that returns to `pending` after having been
+     * `ready`, which is how a recompute surfaces. Once a byte-mutating stage
+     * completes, `url`/`durationMs`/`waveform` above already resolve to the
+     * processed audio variant. See `types/processing.ts`.
+     */
+    processing: z.ZodOptional<z.ZodObject<{
+        transcribe: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        denoise: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        trim: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        waveform: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+    }, "strip", z.ZodTypeAny, {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    }, {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     $type: "dev.antiphony.embed.audio#view";
     url: string;
+    waveform?: number[] | undefined;
     durationMs?: number | undefined;
     alt?: string | undefined;
-    waveform?: number[] | undefined;
     transcript?: {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     } | undefined;
+    processing?: {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    } | undefined;
 }, {
     $type: "dev.antiphony.embed.audio#view";
     url: string;
+    waveform?: number[] | undefined;
     durationMs?: number | undefined;
     alt?: string | undefined;
-    waveform?: number[] | undefined;
     transcript?: {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     } | undefined;
+    processing?: {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+    } | undefined;
 }>;
 type AudioEmbedView = z.infer<typeof AudioEmbedViewSchema>;
 /**
@@ -293,6 +351,13 @@ type AudioEmbedView = z.infer<typeof AudioEmbedViewSchema>;
 declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
     /** Storage id (rkey/doc id). */
     id: z.ZodString;
+    /**
+     * Content CID of the canonical lexicon record (CIDv1, dag-cbor, sha2-256
+     * — the AT Protocol record-CID rule). Computed at write time over the
+     * lexicon projection (public fields only, NOT the storage/tenancy fields
+     * below), so StrongRefs built from it are verifiable content addresses.
+     */
+    cid: z.ZodString;
     /** Origin app that created this record — the multi-tenant isolation key. */
     originAppId: z.ZodString;
     /** Authoring user. A queryable facet, not the tenancy boundary. */
@@ -309,9 +374,62 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
      * opened the branch. Set on replies (deduped, 1–2 ids); absent on prompts
      * (a prompt's repliers are the app's audience policy, not a fixed pair).
      * Inherited down the branch so reply gating is an O(1) field check, never a
-     * thread walk. See `specs/antiphony-data-model.md` §6 "Reply gating".
+     * thread walk.
      */
     threadParticipants: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Author of this reply's thread ROOT (the prompt) — the reply's recipient,
+     * the person whose "replies to me" feed it lands in. Denormalized at write
+     * time so "replies whose root author is X" is a cheap composite-index query
+     * (see `queryByRootAuthor`). Set on replies (`kind === 'reply'`); absent on
+     * prompts. Storage-layer facet, NOT in the public lexicon or the record CID.
+     */
+    rootAuthorId: z.ZodOptional<z.ZodString>;
+    /**
+     * Async audio-processing state (transcribe / denoise), present iff the app
+     * opted into processing on create. Mutated by the processing worker after
+     * the post is created — storage-layer, NOT in the lexicon or the record
+     * CID. See `types/processing.ts`.
+     */
+    processing: z.ZodOptional<z.ZodObject<{
+        transcribe: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        denoise: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        trim: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        waveform: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+    } & {
+        reprocess: z.ZodOptional<z.ZodBoolean>;
+    } & {
+        processedBlobCid: z.ZodOptional<z.ZodString>;
+        processedMimeType: z.ZodOptional<z.ZodString>;
+        processedDurationMs: z.ZodOptional<z.ZodNumber>;
+        waveformPeaks: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        leaseUntil: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>>;
+        updatedAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
+    }, "strip", z.ZodTypeAny, {
+        updatedAt: Date;
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: Date | undefined;
+    }, {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: unknown;
+        updatedAt?: unknown;
+    }>>;
     /** User-authored text (bsky-semantic). May be empty for pure-audio posts. NEVER the transcript. */
     text: z.ZodString;
     /** Optional headline; a prompt feature, not the discriminator. */
@@ -319,20 +437,30 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
     /** Audio (or other) attachment. Audio posts carry an `AudioEmbed`. */
     embed: z.ZodOptional<z.ZodObject<{
         $type: z.ZodLiteral<"dev.antiphony.embed.audio">;
-        /** The audio bytes as a content-addressed storage ref (CID/path). */
+        /** The audio bytes as a content-addressed blob ref (`ref.$link` = CID). */
         audio: z.ZodObject<{
             $type: z.ZodLiteral<"blob">;
-            ref: z.ZodString;
+            ref: z.ZodObject<{
+                $link: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                $link: string;
+            }, {
+                $link: string;
+            }>;
             mimeType: z.ZodString;
             size: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         }, {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         }>;
@@ -346,24 +474,28 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     }, {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     }>>;
     /** Present iff this post is a reply (StrongRef root + parent). */
     reply: z.ZodOptional<z.ZodObject<{
@@ -413,25 +545,28 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
     selfLabels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     createdAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
 }, "strip", z.ZodTypeAny, {
+    cid: string;
     text: string;
     id: string;
-    createdAt: Date;
     originAppId: string;
     authorId: string;
-    kind: "reply" | "prompt";
-    title?: string | undefined;
-    embed?: {
-        $type: "dev.antiphony.embed.audio";
-        audio: {
-            $type: "blob";
-            ref: string;
-            mimeType: string;
-            size: number;
-        };
-        durationMs?: number | undefined;
-        alt?: string | undefined;
-        waveform?: number[] | undefined;
+    kind: "prompt" | "reply";
+    createdAt: Date;
+    processing?: {
+        updatedAt: Date;
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: Date | undefined;
     } | undefined;
+    authorDid?: string | undefined;
+    orgId?: string | null | undefined;
     reply?: {
         root: {
             uri: string;
@@ -442,30 +577,47 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-    authorDid?: string | undefined;
-    orgId?: string | null | undefined;
     threadParticipants?: string[] | undefined;
-}, {
-    text: string;
-    id: string;
-    originAppId: string;
-    authorId: string;
-    kind: "reply" | "prompt";
+    rootAuthorId?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}, {
+    cid: string;
+    text: string;
+    id: string;
+    originAppId: string;
+    authorId: string;
+    kind: "prompt" | "reply";
+    processing?: {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: unknown;
+        updatedAt?: unknown;
+    } | undefined;
+    authorDid?: string | undefined;
+    orgId?: string | null | undefined;
     reply?: {
         root: {
             uri: string;
@@ -476,32 +628,49 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-    createdAt?: unknown;
-    authorDid?: string | undefined;
-    orgId?: string | null | undefined;
     threadParticipants?: string[] | undefined;
-}>, {
-    text: string;
-    id: string;
-    createdAt: Date;
-    originAppId: string;
-    authorId: string;
-    kind: "reply" | "prompt";
+    rootAuthorId?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+    createdAt?: unknown;
+}>, {
+    cid: string;
+    text: string;
+    id: string;
+    originAppId: string;
+    authorId: string;
+    kind: "prompt" | "reply";
+    createdAt: Date;
+    processing?: {
+        updatedAt: Date;
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: Date | undefined;
+    } | undefined;
+    authorDid?: string | undefined;
+    orgId?: string | null | undefined;
     reply?: {
         root: {
             uri: string;
@@ -512,30 +681,47 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
             cid: string;
         };
     } | undefined;
-    langs?: string[] | undefined;
-    selfLabels?: string[] | undefined;
-    authorDid?: string | undefined;
-    orgId?: string | null | undefined;
     threadParticipants?: string[] | undefined;
-}, {
-    text: string;
-    id: string;
-    originAppId: string;
-    authorId: string;
-    kind: "reply" | "prompt";
+    rootAuthorId?: string | undefined;
     title?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio";
         audio: {
             $type: "blob";
-            ref: string;
+            ref: {
+                $link: string;
+            };
             mimeType: string;
             size: number;
         };
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
     } | undefined;
+    langs?: string[] | undefined;
+    selfLabels?: string[] | undefined;
+}, {
+    cid: string;
+    text: string;
+    id: string;
+    originAppId: string;
+    authorId: string;
+    kind: "prompt" | "reply";
+    processing?: {
+        denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        reprocess?: boolean | undefined;
+        processedBlobCid?: string | undefined;
+        processedMimeType?: string | undefined;
+        processedDurationMs?: number | undefined;
+        waveformPeaks?: number[] | undefined;
+        leaseUntil?: unknown;
+        updatedAt?: unknown;
+    } | undefined;
+    authorDid?: string | undefined;
+    orgId?: string | null | undefined;
     reply?: {
         root: {
             uri: string;
@@ -546,12 +732,26 @@ declare const AudioPostRecordSchema: z.ZodEffects<z.ZodObject<{
             cid: string;
         };
     } | undefined;
+    threadParticipants?: string[] | undefined;
+    rootAuthorId?: string | undefined;
+    title?: string | undefined;
+    embed?: {
+        $type: "dev.antiphony.embed.audio";
+        audio: {
+            $type: "blob";
+            ref: {
+                $link: string;
+            };
+            mimeType: string;
+            size: number;
+        };
+        waveform?: number[] | undefined;
+        durationMs?: number | undefined;
+        alt?: string | undefined;
+    } | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
     createdAt?: unknown;
-    authorDid?: string | undefined;
-    orgId?: string | null | undefined;
-    threadParticipants?: string[] | undefined;
 }>;
 type AudioPostRecord = z.infer<typeof AudioPostRecordSchema>;
 /**
@@ -578,35 +778,35 @@ declare const TranscriptEnrichmentRecordSchema: z.ZodObject<{
             endMs: z.ZodNumber;
             text: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            text: string;
             startMs: number;
             endMs: number;
-        }, {
             text: string;
+        }, {
             startMs: number;
             endMs: number;
-        }>, {
             text: string;
+        }>, {
             startMs: number;
             endMs: number;
-        }, {
             text: string;
+        }, {
             startMs: number;
             endMs: number;
+            text: string;
         }>, "many">;
         text: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     }, {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     }>;
@@ -616,16 +816,16 @@ declare const TranscriptEnrichmentRecordSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     createdAt: z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
-    createdAt: Date;
     transcript: {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     };
+    id: string;
+    createdAt: Date;
     subject: {
         uri: string;
         cid: string;
@@ -633,15 +833,15 @@ declare const TranscriptEnrichmentRecordSchema: z.ZodObject<{
     lang?: string | undefined;
     model?: string | undefined;
 }, {
-    id: string;
     transcript: {
         segments: {
-            text: string;
             startMs: number;
             endMs: number;
+            text: string;
         }[];
         text?: string | undefined;
     };
+    id: string;
     subject: {
         uri: string;
         cid: string;
@@ -652,7 +852,13 @@ declare const TranscriptEnrichmentRecordSchema: z.ZodObject<{
 }>;
 type TranscriptEnrichmentRecord = z.infer<typeof TranscriptEnrichmentRecordSchema>;
 /**
- * `dev.antiphony.actor.profile` — port of `com.voxpop.actor.profile`.
+ * `dev.antiphony.actor.profile` — portable actor-profile record shape.
+ *
+ * Lexicon-only: the core never stores, serves, or CRUDs this record — the
+ * caller BFF is the sole authority for profile data. The schema stays in
+ * `@antiphony/shared` so a federating/exporting deployment has a well-known
+ * shape to project a BFF-owned profile into (see specs/core-bff-boundary.md,
+ * "actor.profile lexicon", resolved 2026-07-03).
  */
 declare const ActorProfileRecordSchema: z.ZodObject<{
     handle: z.ZodOptional<z.ZodString>;
@@ -747,7 +953,6 @@ declare const PostRecordPublicSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     text: string;
     createdAt: Date;
-    title?: string | undefined;
     reply?: {
         root: {
             uri: string;
@@ -758,11 +963,11 @@ declare const PostRecordPublicSchema: z.ZodObject<{
             cid: string;
         };
     } | undefined;
+    title?: string | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
 }, {
     text: string;
-    title?: string | undefined;
     reply?: {
         root: {
             uri: string;
@@ -773,6 +978,7 @@ declare const PostRecordPublicSchema: z.ZodObject<{
             cid: string;
         };
     } | undefined;
+    title?: string | undefined;
     langs?: string[] | undefined;
     selfLabels?: string[] | undefined;
     createdAt?: unknown;
@@ -780,106 +986,27 @@ declare const PostRecordPublicSchema: z.ZodObject<{
 type PostRecordPublic = z.infer<typeof PostRecordPublicSchema>;
 /**
  * `AudioPostView` — the hydrated, client-facing shape (the bsky `postView`
- * analogue): record content + author + hydrated embed + per-viewer state.
- * Produced by the (batched) hydrator; the default/public view, with
- * owner-extra arriving via `viewer` + separate authed endpoints, not fat
- * records.
+ * analogue): record content + opaque author references + hydrated embed +
+ * per-viewer state. Produced by the (batched) hydrator; the default/public
+ * view, with owner-extra arriving via `viewer` + separate authed endpoints,
+ * not fat records.
+ *
+ * Author identity is carried as **opaque references**, never a hydrated
+ * profile: `authorId` is the app's own user id (attribution facet) and
+ * `authorDid` is present only when the caller asserted one. Antiphony holds no
+ * user data — the caller BFF hydrates display identity by joining on
+ * `authorId` (see specs/core-surface.md, "The author model").
  */
 declare const AudioPostViewSchema: z.ZodObject<{
     /** at:// URI (or internal ref) identifying the post. */
     uri: z.ZodString;
-    cid: z.ZodOptional<z.ZodString>;
+    /** Content CID of the canonical record (see `AudioPostRecordSchema.cid`). */
+    cid: z.ZodString;
     kind: z.ZodEnum<["prompt", "reply"]>;
-    author: z.ZodObject<{
-        id: z.ZodString;
-        handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        displayName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        avatarUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        bio: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        website: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            url: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            url: string;
-        }, {
-            label: string;
-            url: string;
-        }>, "many">>;
-        bluesky: z.ZodOptional<z.ZodObject<{
-            handle: z.ZodString;
-            did: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            handle: string;
-            did: string;
-        }, {
-            handle: string;
-            did: string;
-        }>>;
-        stats: z.ZodOptional<z.ZodObject<{
-            followers: z.ZodDefault<z.ZodNumber>;
-            following: z.ZodDefault<z.ZodNumber>;
-            prompts: z.ZodDefault<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            followers: number;
-            following: number;
-            prompts: number;
-        }, {
-            followers?: number | undefined;
-            following?: number | undefined;
-            prompts?: number | undefined;
-        }>>;
-        badges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        isVerified: z.ZodOptional<z.ZodBoolean>;
-        createdAt: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodType<unknown, z.ZodTypeDef, unknown>, z.ZodString, z.ZodNumber, z.ZodDate]>, Date, unknown>>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        handle?: string | null | undefined;
-        displayName?: string | null | undefined;
-        bio?: string | null | undefined;
-        avatarUrl?: string | null | undefined;
-        website?: string | null | undefined;
-        links?: {
-            label: string;
-            url: string;
-        }[] | undefined;
-        createdAt?: Date | undefined;
-        bluesky?: {
-            handle: string;
-            did: string;
-        } | undefined;
-        stats?: {
-            followers: number;
-            following: number;
-            prompts: number;
-        } | undefined;
-        badges?: string[] | undefined;
-        isVerified?: boolean | undefined;
-    }, {
-        id: string;
-        handle?: string | null | undefined;
-        displayName?: string | null | undefined;
-        bio?: string | null | undefined;
-        avatarUrl?: string | null | undefined;
-        website?: string | null | undefined;
-        links?: {
-            label: string;
-            url: string;
-        }[] | undefined;
-        createdAt?: unknown;
-        bluesky?: {
-            handle: string;
-            did: string;
-        } | undefined;
-        stats?: {
-            followers?: number | undefined;
-            following?: number | undefined;
-            prompts?: number | undefined;
-        } | undefined;
-        badges?: string[] | undefined;
-        isVerified?: boolean | undefined;
-    }>;
+    /** The acting actor's app-scoped id — an opaque attribution ref, not a profile. */
+    authorId: z.ZodString;
+    /** The author's app-asserted AT Protocol DID, when the caller provided one. */
+    authorDid: z.ZodOptional<z.ZodString>;
     record: z.ZodObject<{
         text: z.ZodString;
         title: z.ZodOptional<z.ZodString>;
@@ -929,7 +1056,6 @@ declare const AudioPostViewSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         text: string;
         createdAt: Date;
-        title?: string | undefined;
         reply?: {
             root: {
                 uri: string;
@@ -940,11 +1066,11 @@ declare const AudioPostViewSchema: z.ZodObject<{
                 cid: string;
             };
         } | undefined;
+        title?: string | undefined;
         langs?: string[] | undefined;
         selfLabels?: string[] | undefined;
     }, {
         text: string;
-        title?: string | undefined;
         reply?: {
             root: {
                 uri: string;
@@ -955,6 +1081,7 @@ declare const AudioPostViewSchema: z.ZodObject<{
                 cid: string;
             };
         } | undefined;
+        title?: string | undefined;
         langs?: string[] | undefined;
         selfLabels?: string[] | undefined;
         createdAt?: unknown;
@@ -962,6 +1089,18 @@ declare const AudioPostViewSchema: z.ZodObject<{
     /** Hydrated audio embed (signed URL + lifted transcript). */
     embed: z.ZodOptional<z.ZodObject<{
         $type: z.ZodLiteral<"dev.antiphony.embed.audio#view">;
+        /**
+         * `url`, `durationMs` and `waveform` are RESOLVED, not copied: once
+         * processing has produced an audio variant they describe that variant
+         * rather than the bytes the client uploaded. They always agree with one
+         * another — a duration and a set of peaks are only meaningful against the
+         * audio `url` actually points at.
+         *
+         * A client that stored `durationMs` at upload time should therefore expect
+         * it to change (trim removes leading/trailing silence), and should render
+         * these three as a set rather than caching them independently. The record's
+         * originals are immutable and unaffected; this is a read-time resolution.
+         */
         url: z.ZodString;
         durationMs: z.ZodOptional<z.ZodNumber>;
         alt: z.ZodOptional<z.ZodString>;
@@ -973,66 +1112,103 @@ declare const AudioPostViewSchema: z.ZodObject<{
                 endMs: z.ZodNumber;
                 text: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                text: string;
                 startMs: number;
                 endMs: number;
-            }, {
                 text: string;
+            }, {
                 startMs: number;
                 endMs: number;
-            }>, {
                 text: string;
+            }>, {
                 startMs: number;
                 endMs: number;
-            }, {
                 text: string;
+            }, {
                 startMs: number;
                 endMs: number;
+                text: string;
             }>, "many">;
             text: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         }, {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         }>>;
+        /**
+         * Per-stage audio-processing status (denoise / trim / transcribe /
+         * waveform), when the app opted into processing. Absent otherwise. A
+         * `pending` stage means the client should poll (or re-render) for the
+         * result — including a stage that returns to `pending` after having been
+         * `ready`, which is how a recompute surfaces. Once a byte-mutating stage
+         * completes, `url`/`durationMs`/`waveform` above already resolve to the
+         * processed audio variant. See `types/processing.ts`.
+         */
+        processing: z.ZodOptional<z.ZodObject<{
+            transcribe: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+            denoise: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+            trim: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+            waveform: z.ZodOptional<z.ZodEnum<["pending", "ready", "failed", "skipped"]>>;
+        }, "strip", z.ZodTypeAny, {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        }, {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         $type: "dev.antiphony.embed.audio#view";
         url: string;
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
         transcript?: {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         } | undefined;
+        processing?: {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        } | undefined;
     }, {
         $type: "dev.antiphony.embed.audio#view";
         url: string;
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
         transcript?: {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         } | undefined;
+        processing?: {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        } | undefined;
     }>>;
     viewer: z.ZodObject<{
         /** True when the authenticated caller authored this post. */
@@ -1056,35 +1232,12 @@ declare const AudioPostViewSchema: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     uri: string;
-    kind: "reply" | "prompt";
-    author: {
-        id: string;
-        handle?: string | null | undefined;
-        displayName?: string | null | undefined;
-        bio?: string | null | undefined;
-        avatarUrl?: string | null | undefined;
-        website?: string | null | undefined;
-        links?: {
-            label: string;
-            url: string;
-        }[] | undefined;
-        createdAt?: Date | undefined;
-        bluesky?: {
-            handle: string;
-            did: string;
-        } | undefined;
-        stats?: {
-            followers: number;
-            following: number;
-            prompts: number;
-        } | undefined;
-        badges?: string[] | undefined;
-        isVerified?: boolean | undefined;
-    };
+    cid: string;
+    authorId: string;
+    kind: "prompt" | "reply";
     record: {
         text: string;
         createdAt: Date;
-        title?: string | undefined;
         reply?: {
             root: {
                 uri: string;
@@ -1095,6 +1248,7 @@ declare const AudioPostViewSchema: z.ZodObject<{
                 cid: string;
             };
         } | undefined;
+        title?: string | undefined;
         langs?: string[] | undefined;
         selfLabels?: string[] | undefined;
     };
@@ -1103,52 +1257,35 @@ declare const AudioPostViewSchema: z.ZodObject<{
         canReply: boolean;
         replyDisabledReason?: "unauthenticated" | "not_a_participant" | undefined;
     };
+    authorDid?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio#view";
         url: string;
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
         transcript?: {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         } | undefined;
+        processing?: {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        } | undefined;
     } | undefined;
-    cid?: string | undefined;
 }, {
     uri: string;
-    kind: "reply" | "prompt";
-    author: {
-        id: string;
-        handle?: string | null | undefined;
-        displayName?: string | null | undefined;
-        bio?: string | null | undefined;
-        avatarUrl?: string | null | undefined;
-        website?: string | null | undefined;
-        links?: {
-            label: string;
-            url: string;
-        }[] | undefined;
-        createdAt?: unknown;
-        bluesky?: {
-            handle: string;
-            did: string;
-        } | undefined;
-        stats?: {
-            followers?: number | undefined;
-            following?: number | undefined;
-            prompts?: number | undefined;
-        } | undefined;
-        badges?: string[] | undefined;
-        isVerified?: boolean | undefined;
-    };
+    cid: string;
+    authorId: string;
+    kind: "prompt" | "reply";
     record: {
         text: string;
-        title?: string | undefined;
         reply?: {
             root: {
                 uri: string;
@@ -1159,6 +1296,7 @@ declare const AudioPostViewSchema: z.ZodObject<{
                 cid: string;
             };
         } | undefined;
+        title?: string | undefined;
         langs?: string[] | undefined;
         selfLabels?: string[] | undefined;
         createdAt?: unknown;
@@ -1168,22 +1306,28 @@ declare const AudioPostViewSchema: z.ZodObject<{
         canReply?: boolean | undefined;
         replyDisabledReason?: "unauthenticated" | "not_a_participant" | undefined;
     };
+    authorDid?: string | undefined;
     embed?: {
         $type: "dev.antiphony.embed.audio#view";
         url: string;
+        waveform?: number[] | undefined;
         durationMs?: number | undefined;
         alt?: string | undefined;
-        waveform?: number[] | undefined;
         transcript?: {
             segments: {
-                text: string;
                 startMs: number;
                 endMs: number;
+                text: string;
             }[];
             text?: string | undefined;
         } | undefined;
+        processing?: {
+            denoise?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            trim?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            transcribe?: "pending" | "ready" | "failed" | "skipped" | undefined;
+            waveform?: "pending" | "ready" | "failed" | "skipped" | undefined;
+        } | undefined;
     } | undefined;
-    cid?: string | undefined;
 }>;
 type AudioPostView = z.infer<typeof AudioPostViewSchema>;