@recursiv/sdk 0.7.83 → 0.7.93

package/dist/resources/discovery.js

@@ -1,4 +1,6 @@
+import { SOCIAL_PROTOCOL_IDS } from '../social-protocol-ids.js';
 import { readFalloverSteps } from './discovery-fallover.js';
+import { discoveryItemIdentities } from './discovery-merge.js';
 import { createDiscoveryTopShare, createProgressiveFeed } from './discovery-progressive.js';
 export * from './discovery-fallover.js';
 export * from './discovery-first-screen.js';
@@ -142,7 +144,8 @@ function recommendationItem(kind, candidate) {
     return { key: `rec:tag:${(nonEmpty(value.slug) ? value.slug : value.name).toLowerCase()}`, kind: 'tag', tag: value };
 }
 const RADAR_KINDS = new Set(['breaking', 'viral', 'story']);
-const RADAR_SOCIAL_KINDS = new Set(['bluesky', 'activitypub', 'nostr']);
+/** A radar member's open network (SOCIAL_PROTOCOL_IDS, Farcaster included before the radar holds any); another kind is skipped. */
+const RADAR_SOCIAL_KINDS = new Set(SOCIAL_PROTOCOL_IDS);
 const httpUrl = (value) => typeof value === 'string' && value.length <= 4096 && /^https?:\/\//i.test(value);
 const countOf = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : null;
 const dimension = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0 ? value : undefined;
@@ -271,7 +274,8 @@ export function pickRadarCluster(clusters, page, options = {}) {
     }
     return breaking[0] ?? unused[0];
 }
-const TOP_NETWORKS = new Set(['bluesky', 'activitypub', 'nostr']);
+/** A feed top's open-network item or lane (SOCIAL_PROTOCOL_IDS); a session keeps only the networks it reads (`readyTop`). */
+const TOP_NETWORKS = new Set(SOCIAL_PROTOCOL_IDS);
 const idString = (value) => typeof value === 'string' && value.length > 0 && value.length <= 4096;
 const counted = (value) => typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null;
 /** The refs an app's seen set may hold for a post: its id, or '<protocol>/<nativeId>' (an ActivityPub id also without https://). */
@@ -339,6 +343,19 @@ function topItemSeenRefs(value) {
 }
 const ordinary = { version: 'discovery-layout-v1', presentation: 'posts', source: 'fallback' };
 const key = (protocol, id) => JSON.stringify([protocol, id]);
+/** The judgment of a read made in `category`: its category filter's selection, when that is the category asked. */
+const judgedInto = (category, filter) => (category && filter?.selected === category ? { judged: category } : {});
+/** The judgment of a read's item at `index`. */
+const judgmentAt = (read, index) => (read.judgments ? read.judgments[index] : read.judged);
+/**
+ * A featured module's theme: its lead window's, only when most of the module's own posts were judged into it (see
+ * DiscoveryModule.theme). Never `mixed`.
+ */
+function judgedTheme(theme, judged) {
+    if (!theme || theme === 'mixed' || !judged.length)
+        return undefined;
+    return judged.filter(category => category === theme).length * 2 > judged.length ? theme : undefined;
+}
 const presentations = new Set(['posts', 'visual', 'conversation', 'video', 'thread', 'longread']);
 /** A gallery strip holds up to twelve image posts gathered from the whole page. */
 export const GALLERY_MAX_ITEMS = 12;
@@ -464,7 +481,7 @@ export class DiscoveryFeedSession {
                     ? { key: key(row.post.protocol, row.post.nativeId), kind: 'social', post: row.post }
                     : { key: key('minds', row.id), kind: 'minds', post: row }));
                 const read = { layout: response.meta.discovery ?? ordinary, partial: response.meta.category_filter?.status === 'partial',
-                    ...(response.meta.compass_filter ? { compass: response.meta.compass_filter } : {}) };
+                    ...(response.meta.compass_filter ? { compass: response.meta.compass_filter } : {}), ...judgedInto(this.category, response.meta.category_filter) };
                 if (!this.filtering)
                     return { items, ...read };
                 head ??= read;
@@ -518,7 +535,7 @@ export class DiscoveryFeedSession {
         const kept = data.items.flatMap((post, index) => this.metNetworkPost(post) ? [] : [{ post, index }]);
         const layout = data.discovery ?? ordinary;
         return { items: kept.map(({ post }) => ({ key: key(post.protocol, post.nativeId), kind: 'social', post })), layout, partial: data.categoryFilter?.status === 'partial',
-            ...(kept.length !== data.items.length ? { layouts: kept.map(({ index }) => windowLayout(layout, index)) } : {}) };
+            ...(kept.length !== data.items.length ? { layouts: kept.map(({ index }) => windowLayout(layout, index)) } : {}), ...judgedInto(this.category, data.categoryFilter) };
     }
     /** An open-network post in the member's seen set (options.seen: '<protocol>/<nativeId>', an ActivityPub id also without https://). */
     metNetworkPost(post) {
@@ -607,7 +624,8 @@ export class DiscoveryFeedSession {
             const items = (indexed ? data.items.filter(post => !this.seen.has(key(post.protocol, post.nativeId))) : data.items).filter(post => !this.metNetworkPost(post));
             if (items.length) {
                 stream.done = !topics.length;
-                return { items: items.map(post => ({ key: key(post.protocol, post.nativeId), kind: 'social', post })), layout: data.discovery ?? ordinary, partial };
+                return { items: items.map(post => ({ key: key(post.protocol, post.nativeId), kind: 'social', post })), layout: data.discovery ?? ordinary, partial,
+                    ...judgedInto(this.category, data.categoryFilter) };
             }
         }
         while (topics[0] && passedOver() && !topics[0].cursor?.startsWith(INDEX_CURSOR))
@@ -680,17 +698,25 @@ export class DiscoveryFeedSession {
         // Round-robin before grouping: the largest network cannot occupy every slot.
         // Each item carries the judgment for its own window of its source response,
         // so one page can feature several modules instead of one per source batch.
+        // A post is shown once by every identity (discoveryItemIdentities): a second note carrying a clip already placed is
+        // the same post to a reader, on this page or a later one.
         const mixed = [];
         for (let index = 0; index < Math.max(0, ...reads.map(read => read.items.length)); index++)
             for (const read of reads) {
                 const item = read.items[index];
-                if (!item || this.seen.has(item.key))
+                if (!item)
+                    continue;
+                const identities = discoveryItemIdentities(item);
+                if (identities.some(identity => this.seen.has(identity)))
                     continue;
-                this.seen.add(item.key);
-                mixed.push({ item, layout: read.layouts?.[index] ?? windowLayout(read.layout, index) });
+                for (const identity of identities)
+                    this.seen.add(identity);
+                const judged = judgmentAt(read, index);
+                mixed.push({ item, layout: read.layouts?.[index] ?? windowLayout(read.layout, index), ...(judged ? { judged } : {}) });
             }
-        // Deduplication memory is bounded independently of the UI's virtual window.
-        while (this.seen.size > 4096)
+        // Deduplication memory is bounded independently of the UI's virtual window: an open-network post holds a few
+        // identities (its key, its id and its files), so the bound that held 4096 keys holds four times as many entries.
+        while (this.seen.size > 16_384)
             this.seen.delete(this.seen.values().next().value);
         const modules = topItems.map((item, index) => this.topModule(this.page, index, item));
         const page = this.page++;
@@ -707,9 +733,22 @@ export class DiscoveryFeedSession {
             const onPage = remaining.filter(row => members.has(row.item.key)).map(row => row.item);
             const carried = new Set(onPage.map(item => item.key));
             // Members this page did not carry come from the story's own reads; one an earlier page showed stays shown there.
-            const read = (await this.memberPosts(cluster)).filter(item => !carried.has(item.key) && !this.seen.has(item.key));
+            // They are taken one at a time in the story's member order, each adding its identities as it is kept, so two
+            // members of one read that carry one clip (a mirror note on another server) show once: the one the story lists first.
+            const order = (item) => cluster.memberKeys.indexOf(item.key);
+            const read = [];
+            for (const item of [...await this.memberPosts(cluster)].sort((a, b) => order(a) - order(b))) {
+                if (carried.has(item.key))
+                    continue;
+                const identities = discoveryItemIdentities(item);
+                if (identities.some(identity => this.seen.has(identity)))
+                    continue;
+                for (const identity of identities)
+                    this.seen.add(identity);
+                read.push(item);
+            }
             // Under the story, posts keep the server's member order: the lead media member first, then by member score.
-            clusterItems = [...onPage, ...read].sort((a, b) => cluster.memberKeys.indexOf(a.key) - cluster.memberKeys.indexOf(b.key));
+            clusterItems = [...onPage, ...read].sort((a, b) => order(a) - order(b));
             remaining = remaining.filter(row => !members.has(row.item.key));
             for (const memberKey of cluster.memberKeys)
                 this.seen.add(memberKey);
@@ -742,7 +781,8 @@ export class DiscoveryFeedSession {
             const selected = visual ? images : discussion ? conversations : thread ? quotes : [first];
             const items = selected.map(row => row.item);
             const type = video ? 'DiscoveryVideo' : visual ? 'DiscoveryGallery' : discussion ? 'DiscoveryConversation' : thread ? 'DiscoveryThread' : longread ? 'DiscoveryLongRead' : 'DiscoveryPosts';
-            const theme = presentation !== 'posts' && first.layout.theme && first.layout.theme !== 'mixed' ? first.layout.theme : undefined;
+            // Titled after its lead window's theme only when most of its own posts were judged into it (DiscoveryModule.theme).
+            const theme = presentation !== 'posts' ? judgedTheme(first.layout.theme, selected.map(row => row.judged)) : undefined;
             modules.push({ id: `discovery-${page}-${index}-${items[0].key}`, presentation, source: presentation === 'posts' ? 'fallback' : 'jev', items, ...(theme ? { theme } : {}),
                 spec: { root: 'module', elements: { module: { type, props: { itemKeys: items.map(item => item.key) }, children: [] } } } });
             const selectedKeys = new Set(items.map(item => item.key));
@@ -848,7 +888,7 @@ export class DiscoveryFeedSession {
         }
         const lanes = new Map();
         const networks = value.networks && typeof value.networks === 'object' ? value.networks : {};
-        for (const protocol of TOP_NETWORKS) {
+        for (const protocol of SOCIAL_PROTOCOL_IDS) {
             const entries = networks[protocol];
             if (!streams.has(protocol) || !Array.isArray(entries))
                 continue;
@@ -917,7 +957,9 @@ export class DiscoveryFeedSession {
             const read = at >= 0 ? reads[at] : null;
             if (read) {
                 const kept = read.previews ? [] : read.items;
-                reads[at] = { ...read, items: [...lane, ...kept], layouts: [...lane.map(() => ordinary), ...kept.map((_item, index) => read.layouts?.[index] ?? windowLayout(read.layout, index))] };
+                // The lane's posts lead the read's; they carry no judgment of the read's category.
+                reads[at] = { ...read, items: [...lane, ...kept], layouts: [...lane.map(() => ordinary), ...kept.map((_item, index) => read.layouts?.[index] ?? windowLayout(read.layout, index))],
+                    judgments: [...lane.map(() => undefined), ...kept.map((_item, index) => judgmentAt(read, index))] };
             }
             else if (this.streams.some(stream => stream.protocol === protocol))
                 reads.push({ items: lane, layout: ordinary, partial: false });
@@ -930,10 +972,15 @@ export class DiscoveryFeedSession {
             const found = top.posts.get(row.key) ?? carried.get(row.key);
             if (!found || this.seen.has(row.key))
                 continue;
+            const identities = discoveryItemIdentities(found);
+            if (identities.some(identity => this.seen.has(identity)))
+                continue;
             const position = top.positions.get(row.ref) ?? placed.length;
             placed.push({ ...found, top: { ref: row.ref, position, block: position < 10 ? 'top' : 'below' } });
             this.seen.add(row.key);
             this.topKeys.add(row.key);
+            for (const identity of identities)
+                this.seen.add(identity);
         }
         return placed;
     }

package/dist/resources/feeds.d.ts

@@ -1,4 +1,5 @@
 import type { HttpClient } from '../client.js';
+import { type SocialProtocolId } from '../social-protocol-ids.js';
 import type { CompassFilterMeta, StoryOutlets } from '../types.js';
 /**
  * The top of a feed: what the member (or a visitor) is most likely to engage with, rotated by what they have seen.
@@ -8,9 +9,17 @@ import type { CompassFilterMeta, StoryOutlets } from '../types.js';
  * Every tap target is in the app: a Minds post by id, an open-network post by `/social/post/<protocol>/<id>`, a story
  * by id. Nothing here is a URL on another network.
  */
-/** The open networks whose lanes a top carries. */
-export type FeedTopNetwork = 'bluesky' | 'activitypub' | 'nostr';
+/**
+ * The open networks whose lanes a top may carry: every SOCIAL_PROTOCOL_IDS network (0.7.87: Farcaster before any top
+ * carries a Farcaster lane or item).
+ */
+export type FeedTopNetwork = SocialProtocolId;
 export declare const FEED_TOP_NETWORKS: readonly FeedTopNetwork[];
+/**
+ * A top's lanes, or their states, by network: Bluesky, ActivityPub and Nostr are always named; a network listed later
+ * (Farcaster) only once the API carries its lane, so read `networks.farcaster ?? []`.
+ */
+export type FeedTopNetworkMap<T> = Record<'bluesky' | 'activitypub' | 'nostr', T> & Partial<Record<FeedTopNetwork, T>>;
 /** Where a tap on an item goes, always in the app. `path` is the app's own page of a network post, never its URL there. */
 export type FeedTopTarget = {
     kind: 'post';
@@ -103,7 +112,7 @@ export interface FeedStory {
      * are politics. Hide politics (`compass: 'hide'`) leaves such a story out. Absent from a server older than 0.7.67.
      */
     political?: boolean;
-    sources: Partial<Record<'outlet' | 'hackernews' | 'bluesky' | 'activitypub' | 'nostr' | 'minds', number>>;
+    sources: Partial<Record<'outlet' | 'hackernews' | SocialProtocolId | 'minds', number>>;
     /** How many outlets reported it (StoryOutlets): the number every surface names for the story. Absent from a server older than 0.7.71. */
     outlets?: StoryOutlets;
     media: {
@@ -141,13 +150,13 @@ export interface FeedTopMeta {
     /** 'safe' for a member on safe defaults, 'open' for one who turned them off. */
     safety: 'safe' | 'open';
     mindsSource: 'member' | 'anonymous' | 'none' | 'following';
-    networks: Record<FeedTopNetwork, 'ok' | 'unavailable'> | null;
+    networks: FeedTopNetworkMap<'ok' | 'unavailable'> | null;
     compass_filter?: CompassFilterMeta;
 }
 /** GET /feeds/top. `networks` is null on a feed with no lanes (Following, a story); `lead` is null when the feed has no story. */
 export interface FeedTopResponse {
     items: FeedTopItem[];
-    networks: Record<FeedTopNetwork, FeedTopNetworkEntry[]> | null;
+    networks: FeedTopNetworkMap<FeedTopNetworkEntry[]> | null;
     lead: FeedStory | null;
     meta: FeedTopMeta;
 }
@@ -179,7 +188,7 @@ export interface PublicFeedTopMeta {
 /** A visitor's top (`feeds.publicTop`): safe items only, the same for every visitor in one 15-minute bucket. */
 export interface PublicFeedTopResponse {
     items: FeedTopItem[];
-    networks: Record<FeedTopNetwork, FeedTopNetworkEntry[]> | null;
+    networks: FeedTopNetworkMap<FeedTopNetworkEntry[]> | null;
     lead: FeedStory | null;
     meta: PublicFeedTopMeta;
 }

package/dist/resources/feeds.js

@@ -1,5 +1,6 @@
 import { NotFoundError, RecursivError } from '../errors.js';
-export const FEED_TOP_NETWORKS = ['bluesky', 'activitypub', 'nostr'];
+import { SOCIAL_PROTOCOL_IDS } from '../social-protocol-ids.js';
+export const FEED_TOP_NETWORKS = SOCIAL_PROTOCOL_IDS;
 export class FeedsResource {
     http;
     constructor(http) {

package/dist/resources/integrations.d.ts

@@ -90,6 +90,9 @@ export interface UpdateAgentIntegrationInput {
     allowed_tools?: string[];
 }
 export interface PendingToolExecution {
+    /** First-party builder identity is supplied by the server, never inferred from tool name. */
+    builder_approval?: true;
+    details_withheld?: boolean;
     id: string;
     conversation_id: string;
     agent: {

package/dist/resources/privacy.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from '../client.js';
+import type { PrivacyCapabilities } from '../privacy/index.js';
+import type { SingleResponse } from '../types.js';
+/**
+ * What the deployed API enforces. Pair it with `@recursiv/sdk/privacy`, which says what each fact means and whether
+ * the installed SDK marks it enforced: render a privacy sentence only when both do (`isFactLive`).
+ */
+export declare class PrivacyResource {
+    private client;
+    constructor(client: HttpClient);
+    /** GET /privacy/capabilities: the platform facts this deployment's build enforces, and its commit. Any API key. */
+    capabilities(): Promise<SingleResponse<PrivacyCapabilities>>;
+}

package/dist/resources/privacy.js

@@ -0,0 +1,14 @@
+/**
+ * What the deployed API enforces. Pair it with `@recursiv/sdk/privacy`, which says what each fact means and whether
+ * the installed SDK marks it enforced: render a privacy sentence only when both do (`isFactLive`).
+ */
+export class PrivacyResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** GET /privacy/capabilities: the platform facts this deployment's build enforces, and its commit. Any API key. */
+    capabilities() {
+        return this.client.get('/privacy/capabilities');
+    }
+}

package/dist/resources/protocols.d.ts

@@ -1,6 +1,7 @@
 import type { HttpClient } from '../client.js';
 import type { CompassFilterMeta, DiscoveryLayout, PaginatedResponse, PaginationParams, SingleResponse, StoryOutlets } from '../types.js';
 import type { CuratorStoryPostsPage } from './curator.js';
+import type { NativeWriteProtocol, SocialProtocolId } from '../social-protocol-ids.js';
 /** Canonical protocol operation names returned by the adapter registry. */
 export declare const PROTOCOL_CAPABILITY_OPERATIONS: readonly ["discover", "stream", "backfill", "search", "resolveIdentity", "fetchProfile", "fetchThread", "publish", "reply", "react", "repost", "follow", "delete", "health", "checkpoint"];
 export declare const PROTOCOL_CAPABILITY_STATUSES: readonly ["supported", "planned", "unsupported"];
@@ -426,8 +427,55 @@ export interface FederationIdentityView {
     origin: string | null;
     identity: FederationIdentity | null;
 }
+/** A native network every eligible member is on by rule (Farcaster joins later). */
+export type NativeNetwork = 'activitypub' | 'atproto' | 'nostr';
+/**
+ * A member's state on one native network. `ready`: on by rule, set up on their first public post, first interaction
+ * there, or `activateNetwork` ("Will be set up when you first post or interact"). `pending`: being set up, or waiting
+ * for the setup budget (`retryAt`). `off`: the member turned it off (`reason: 'opted_out'`), it is not available to them
+ * yet (`not_rolled_out`), or their profile is private (`private_profile`, AT Protocol and Nostr only; `setNetwork`
+ * with `enabled: true` turns it on). `needs_action`: the member must act first (`age_band_required`,
+ * `needs_verified_email`). `locked`: held off by a rule the member cannot change.
+ */
+export type NativeNetworkState = 'ready' | 'on' | 'pending' | 'off' | 'error' | 'locked' | 'needs_action';
+export interface NativeNetworkPresence {
+    network: NativeNetwork;
+    state: NativeNetworkState;
+    /** Why, as a code: `opted_out`, `not_rolled_out`, `private_profile`, `age_band_required`, `needs_verified_email`, `activation_failed`... */
+    reason: string | null;
+    /** `hosted` (a Minds-run ActivityPub actor or AT Protocol account), `managed` (a Minds-held Nostr key) or `attached`. */
+    mode: 'hosted' | 'managed' | 'attached';
+    /** The member's address on the network, set up or not, when the server can say it. */
+    handle: string | null;
+    /** Which identity a one-tap like, repost, reply or follow uses when the member also linked an outside account. */
+    engageDefault: 'native' | 'linked';
+    activatedAt: string | null;
+    optedOutAt: string | null;
+    removePast: boolean;
+}
+export interface NativeNetworkActivation {
+    outcome: 'activated' | 'already_on' | 'pending' | 'in_flight' | 'needs_action' | 'error' | 'not_eligible' | 'refused' | 'unavailable';
+    presence: NativeNetworkPresence;
+    /** When the setup budget frees, for `pending`. */
+    retryAt: string | null;
+}
+export interface NativeNetworkOff {
+    outcome: 'off';
+    presence: NativeNetworkPresence;
+    /** `failed`: the member is off, but removing what was shared did not start; call `setNetwork` again to retry it. */
+    retraction: 'queued' | 'failed' | 'none';
+}
+export interface SetNativeNetworkInput {
+    enabled: boolean;
+    /** Turning off: also remove what was already shared there (the Settings sheet checks this by default). */
+    removePast?: boolean;
+}
 export interface SocialSourceRef {
-    protocol: 'bluesky' | 'activitypub' | 'nostr';
+    /**
+     * 0.7.87: any SOCIAL_PROTOCOL_IDS network, Farcaster (an FID, or a `<fid>:0x<hash>` CastId) before its reader serves a
+     * post. A source to show, mute, hide or report; a native write takes only a NativeWriteProtocol network.
+     */
+    protocol: SocialProtocolId;
     kind: 'actor' | 'post';
     nativeId: string;
 }
@@ -474,7 +522,7 @@ export interface NativeReplyPrepareInput {
     clientMutationId: string;
     text: string;
     parent: {
-        protocol: SocialSourceRef['protocol'];
+        protocol: NativeWriteProtocol;
         nativeId: string;
         readRef?: string;
     };
@@ -491,7 +539,7 @@ export interface NativeReplyPrepareInput {
 }
 export interface NativeFollowSourceInput {
     accountId: string;
-    protocol: SocialSourceRef['protocol'];
+    protocol: NativeWriteProtocol;
     nativeId: string;
 }
 export interface NativeFollowPrepareInput extends NativeFollowSourceInput {
@@ -536,7 +584,7 @@ export interface NativeFollowState extends NativeFollowReceipt {
 /** One connected account on the source's network, as the account lists describe it. */
 export interface NativeFollowAccount {
     id: string;
-    protocol: SocialSourceRef['protocol'];
+    protocol: NativeWriteProtocol;
     nativeId: string;
     handle: string;
     serverUrl: string;
@@ -545,7 +593,7 @@ export interface NativeFollowAccount {
 }
 /** Every connected account's relationship with one source, from one read. */
 export interface NativeFollowStates {
-    protocol: SocialSourceRef['protocol'];
+    protocol: NativeWriteProtocol;
     nativeId: string;
     /** False when native follows are off for this app; accounts are still listed, and no state is read. */
     enabled: boolean;
@@ -578,7 +626,7 @@ export interface NativeFollowReview {
 }
 export interface NativeLikeSourceInput {
     accountId: string;
-    protocol: SocialSourceRef['protocol'];
+    protocol: NativeWriteProtocol;
     nativeId: string;
 }
 export interface NativeLikePrepareInput extends NativeLikeSourceInput {
@@ -644,7 +692,7 @@ export interface NativeLikeReview {
 }
 export interface NativeRepostSourceInput {
     accountId: string;
-    protocol: SocialSourceRef['protocol'];
+    protocol: NativeWriteProtocol;
     nativeId: string;
 }
 export interface NativeRepostPrepareInput extends NativeRepostSourceInput {
@@ -773,7 +821,7 @@ export interface NativeReplyBatch {
             serverUrl: string;
         } | null;
         parent: {
-            protocol: SocialSourceRef['protocol'];
+            protocol: NativeWriteProtocol;
             nativeId: string;
             sourceUrl: string;
             authorId: string;
@@ -910,7 +958,7 @@ export interface NativeNostrReplyResult {
     text: string;
     /** `readRef`: a linked ActivityPub source's public reader id, for the conversation read (replies saved before it existed have none). */
     source: {
-        protocol: SocialSourceRef['protocol'];
+        protocol: NativeWriteProtocol;
         nativeId: string;
         sourceUrl: string;
         readRef?: string;
@@ -1321,7 +1369,8 @@ export interface SocialTrendFeed extends SocialTrendProvenance {
     };
 }
 /** A member of a radar cluster: a headline or excerpt and a link only, never a body. */
-export type SocialRadarSourceKind = 'outlet' | 'hackernews' | 'bluesky' | 'activitypub' | 'nostr' | 'minds';
+/** 0.7.87: an open-network member's kind is any SOCIAL_PROTOCOL_IDS network, Farcaster before the radar holds any. */
+export type SocialRadarSourceKind = 'outlet' | 'hackernews' | SocialProtocolId | 'minds';
 export interface SocialRadarMember {
     kind: SocialRadarSourceKind;
     /** outlet: the article url; hackernews: the `hn:<id>` candidate id; social: JSON `[protocol, nativeId]`; minds: the post id. */
@@ -1748,12 +1797,27 @@ export interface SocialConversation {
     hiddenByViewer?: true;
     viewerControls?: Array<Pick<SocialSourceControl, 'source' | 'control'>>;
 }
+/**
+ * A followed account's status on a Following page, in the server's order (SocialFollowingFeed.ts
+ * FOLLOWING_SOURCE_STATUSES). `late` (added after 0.7.82): the account's read had not answered at the page's deadline;
+ * it is read again on a later page and is never a failure. APIs before it name such an account `unavailable` with
+ * `late: true`.
+ */
+export declare const SOCIAL_FOLLOWING_SOURCE_STATUSES: readonly ["ok", "late", "unavailable", "rate_limited", "unsupported_protocol"];
+export type SocialFollowingSourceStatus = typeof SOCIAL_FOLLOWING_SOURCE_STATUSES[number];
 export interface SocialFollowingSource {
     subscriptionId: string;
     protocol: string;
     nativeId: string;
-    status: 'ok' | 'unavailable' | 'rate_limited' | 'unsupported_protocol';
+    /**
+     * `late`: the account's read has not answered yet; it is read again on a later page. `ok` with `late: true`: the
+     * account's last-held first page, served while its fresh read goes on. `unavailable` is a read that failed, or one
+     * still late after its reads again.
+     */
+    status: SocialFollowingSourceStatus;
     moreAvailable: boolean | null;
+    /** The account is read again on a later page: never show it as a failure; read the next page for its posts. */
+    late?: true;
 }
 /** A bounded batch of recent author windows. Continue the cursor to read more followed accounts. */
 export interface SocialFollowingFeed {
@@ -1764,6 +1828,10 @@ export interface SocialFollowingFeed {
     totalAccounts: number;
     postsPerAccount: number;
     coverage: 'recent_original_posts';
+    /** The networks with an account named late on this page (absent from older APIs). */
+    lateNetworks?: string[];
+    /** How long this page waited for an account's first read on each network, in ms (absent from older APIs). */
+    deadlineMs?: number;
 }
 export declare class ProtocolsResource {
     private client;
@@ -2134,6 +2202,26 @@ export declare class ProtocolsResource {
         disconnected: true;
         providerRevocation: 'acknowledged' | 'unconfirmed';
     }>>;
+    /**
+     * The signed-in member's native networks in the key's app (ActivityPub, AT Protocol, Nostr): each one's state, reason
+     * and address. Read-only: it never sets anything up. Needs `users:read`.
+     */
+    networks(): Promise<SingleResponse<{
+        networks: NativeNetworkPresence[];
+    }>>;
+    /**
+     * "Set up now": sets up a network that is `ready` (or `pending`, or failed) at once, instead of on the member's first
+     * post. Never undoes their off switch (409 `network_off`) or a private profile's rule (409 `private_profile`): use
+     * `setNetwork` for those. Over the setup budget it answers `pending` with `retryAt`. Needs `users:write`.
+     */
+    activateNetwork(network: NativeNetwork): Promise<SingleResponse<NativeNetworkActivation>>;
+    /**
+     * The member's switch for one network. `{ enabled: false, removePast: true }` turns it off and removes what was
+     * shared there (reversible: turning it back on serves the same identity; remote followers may need to follow again).
+     * `{ enabled: true }` turns it back on or sets it up. Refusals: 403 `network_locked`, 409 `not_rolled_out` or
+     * `age_band_required`. Needs `users:write`.
+     */
+    setNetwork(network: NativeNetwork, input: SetNativeNetworkInput): Promise<SingleResponse<NativeNetworkActivation | NativeNetworkOff>>;
     /** Current Minds-hosted ActivityPub state for this app user; never provisions. */
     federationIdentity(): Promise<SingleResponse<FederationIdentityView>>;
     /** Explicit opt-in; the platform provisions once and never rotates keys or re-enables a disabled identity on retry. */

package/dist/resources/protocols.js

@@ -28,6 +28,13 @@ export const PROTOCOL_ADAPTER_MATURITIES = Object.freeze([
     'beta',
     'stable',
 ]);
+const NATIVE_NETWORKS = ['activitypub', 'atproto', 'nostr'];
+function nativeNetworkPath(network) {
+    if (!NATIVE_NETWORKS.includes(network)) {
+        throw new ValidationError({ type: 'validation_error', code: 'invalid_network', message: 'network must be activitypub, atproto or nostr' });
+    }
+    return `/protocols/networks/${network}`;
+}
 function hostedIdentityPath(id) {
     if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {
         throw new ValidationError({ type: 'validation_error', code: 'invalid_identity_id', message: 'A valid hosted identity connection ID is required' });
@@ -42,6 +49,19 @@ function hostedIdentityPath(id) {
 export function viralItemHasVideo(item) {
     return item.post.media.some(media => media.type === 'video');
 }
+/**
+ * A followed account's status on a Following page, in the server's order (SocialFollowingFeed.ts
+ * FOLLOWING_SOURCE_STATUSES). `late` (added after 0.7.82): the account's read had not answered at the page's deadline;
+ * it is read again on a later page and is never a failure. APIs before it name such an account `unavailable` with
+ * `late: true`.
+ */
+export const SOCIAL_FOLLOWING_SOURCE_STATUSES = Object.freeze([
+    'ok',
+    'late',
+    'unavailable',
+    'rate_limited',
+    'unsupported_protocol',
+]);
 /** Only the radar's own fields travel; caller scope or destination extras never reach the query string. */
 /** Forwarded only when given, so a default read makes exactly the call it always made. */
 const readOptions = (options) => options ? [options] : [];
@@ -488,6 +508,31 @@ export class ProtocolsResource {
         hostedIdentityPath(id);
         return this.client.delete(`/protocols/social/accounts/${encodeURIComponent(id)}`);
     }
+    /**
+     * The signed-in member's native networks in the key's app (ActivityPub, AT Protocol, Nostr): each one's state, reason
+     * and address. Read-only: it never sets anything up. Needs `users:read`.
+     */
+    networks() {
+        return this.client.get('/protocols/networks');
+    }
+    /**
+     * "Set up now": sets up a network that is `ready` (or `pending`, or failed) at once, instead of on the member's first
+     * post. Never undoes their off switch (409 `network_off`) or a private profile's rule (409 `private_profile`): use
+     * `setNetwork` for those. Over the setup budget it answers `pending` with `retryAt`. Needs `users:write`.
+     */
+    activateNetwork(network) {
+        return this.client.post(`${nativeNetworkPath(network)}/activate`, {});
+    }
+    /**
+     * The member's switch for one network. `{ enabled: false, removePast: true }` turns it off and removes what was
+     * shared there (reversible: turning it back on serves the same identity; remote followers may need to follow again).
+     * `{ enabled: true }` turns it back on or sets it up. Refusals: 403 `network_locked`, 409 `not_rolled_out` or
+     * `age_band_required`. Needs `users:write`.
+     */
+    setNetwork(network, input) {
+        const body = input.enabled ? { enabled: true } : { enabled: false, ...(input.removePast !== undefined ? { remove_past: input.removePast } : {}) };
+        return this.client.put(nativeNetworkPath(network), body);
+    }
     /** Current Minds-hosted ActivityPub state for this app user; never provisions. */
     federationIdentity() {
         return this.client.get('/protocols/social/federation/identity');