@recursiv/sdk 0.7.70 → 0.7.71

package/README.md

@@ -74,7 +74,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 ### AI Agents
 | Resource | Key methods |
 |----------|------------|
-| `r.agents` | `create`, `update`, `chat`, `chatStream`, `retryChatStream`, `grantProjectAccess`, `conversations` |
+| `r.agents` | `create`, `update`, `chat`, `chatStream`, `retryChatStream`, `grantProjectAccess`, `conversations`, `discover` (the app's agent directory: server search and sort, keyless-readable) |
 | `r.e2ee` | `status`, `registerDevice`, `devices`, `revokeDevice` (`{ cascade }` to also revoke devices approved through it; 409 `has_dependents` otherwise), `requestResetCode` and `resetAccount` (reset encrypted chat with an emailed code where `status().accountReset`), `publishKeyPackages`, `keyPackageStatus`, `claimKeyPackage`, `appendEvent`, `events`, `acknowledge`, `conversations`, `requestStart` and `cancelStartRequest` (ask the other person to encrypt a chat when they have no device yet: a message with `metadata.kind` `e2ee_start_request`; the live ones are `ConversationDetail.encryption_requests`); device linking by scan: `createLink`, `link`, `scannedLink`, `approveLink`, `completeLink`, `linkProgress`, `cancelLink` (flag-gated E2EE v2 transport; its doorbell is `r.realtime.onE2eeEvent`, which carries a small message's stored ciphertext to the owner's own sockets; link and device changes arrive on `r.realtime.onE2eeLink` and `onE2eeDevices`) |
 | `r.brain` | `sendMessage` |
 | `r.commands` | `execute`, `gatePrompt` |
@@ -99,14 +99,16 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.communities` | `create`, `join`, `search`, `members` |
 | `r.chat` | `send`, `dm`, `createGroup` (`encrypted: true` for an end-to-end encrypted group, 0.7.59), `messages` (cursor paging), `acceptRequest`, `declineRequest`, `leave`, `deleteConversation`; a private group's admin: `addMembers`, `removeMember`, `updateGroup` (0.7.59) |
 | `r.tags` | `create`, `list` |
+| `r.signals` | `batch` (up to 100 engagement signals, such as views, dwell and hides, for the member's own ranking; `keepalive` for a page-leave flush), `record` (one signal) (0.7.71) |
 | `r.curator` | `today` (World Today; a world story can carry `story_key` and `discussion`, its count across networks), `storyPosts` / `memberStoryPosts` (one page of a story's posts, keyless or under the member's key), `storyPostPages` (walk every page), `forYou`, `run`, `refreshIfStale`, `seedDeck` |
 | `r.uploads` | `uploadMedia` — upload post/chat bytes end to end |
+| `r.judgments` | Jev's labels of a post (0.7.71): `get({ kind, id })` (the author and staff get every judgment and the safety verdict; other members the category and the compass band in words; `status: 'unavailable'` is returned, not thrown), keyless `getPublic(projectId, { kind, id })` (the category only), `dispute(judgmentId, { question_key, proposed, note? })` (the author's dispute is an appeal; a repeat returns `existing: true`), staff `review(judgmentId, { outcome, proposed?, note?, apply_to_shared? })` (sent once; 202 `awaiting_reviewer` until a compass label's second reviewer, or an agreeing Jev re-judge; `isJudgmentSharedWordsError` for the 409) |
 | `r.video` | `entitlement` (may the caller publish video, and how much is left), `createUpload`, `renewUpload` (the creator's fresh TUS credentials for the same video, with `createUpload`'s `resumeGrant`, so a resume past the hour continues it; 0.7.63), `getStatus`, `getPlaybackToken` |
 
 ### Platform
 | Resource | Purpose |
 |----------|---------|
-| `r.settings` | User preferences (including app-scoped content choices), sessions (`revokeOtherSessions` keeps this device), password management, email change (`requestConfirmationCode` for accounts with no password) |
+| `r.settings` | User preferences (including app-scoped content choices), sessions (`revokeOtherSessions` keeps this device), password management, email change (`requestConfirmationCode` for accounts with no password), deactivation (`disableAccount({ password })`, 0.7.71; 404 on an API that does not serve it) |
 | `r.billing` | Usage tracking, subscriptions, checkout |
 | `r.appSubscriptions` | Consumer app plans: `checkout`, `status`, `createPortalSession`, `previewTierChange`, `changeTier` |
 | `r.boosts` | Promoted posts: `create`, `mine`, `balance`, `pause`, `resume`, `cancel`, `recordEvent`, `topup`, `confirmTopup`; admin `listPendingReview`, `review`, `grant` |
@@ -138,6 +140,18 @@ Render candidate `content` as plain text and respect
 API failures, including routes absent from an older
 deployment, throw the normal SDK errors; do not present them as an empty queue.
 
+### Ingestion health (0.7.71)
+
+`r.protocols.ingestionHealth()` reads `GET /protocols/ingestion/health`: counts-only
+health for the key's app, so an operator can see whether each ingestion lane reaches
+done or dies part way without SQL. It needs the same key and authority as the
+candidate reads, but not the `content_intelligence_admin` binding. It sends no query
+(the API rejects one). Per lane: `jobs` counts, the open job (`current`: its
+`position`, `pages_committed`, `consecutive_failures`, `lease_expired`,
+`starved_since`), `last_done_at`, 24-hour `activity` by reason, and `dead_letters`
+by reason and position; plus open or counting `circuits`. A section that does not
+answer reads as null and is named in `unavailable`; errors throw.
+
 ## Configuration
 
 ```typescript
@@ -640,7 +654,7 @@ Standalone public publication uses `protocols.prepareNativePost({ clientMutation
 
 To delete a post everywhere, link its network copies when you cross-post: pass `crossPostOf: post.id` (the member's own post in this app, from `sdk.posts`) to `prepareNativePost` and to `prepareNativeNostr(id, { action: 'publish', content, crossPostOf })`. Later, `nativePostHistory({ crossPostOf: post.id })` lists exactly that post's copies, each with `crossPostOf` set: delegated items are removed with `prepareNativePostRemoval`/`removeNativePost`, and `type: 'nostr'` items (original notes, which this SDK's history lists; the REST route returns them only with `include=nostr` or `crossPostOf`, so older apps keep the delegated-only shape) with the Nostr signing flow (`prepareNativeNostr(identityId, { action: 'delete', postId: eventId })`). Another member's post, or one from another app, answers `not_found`; copies prepared without `crossPostOf` stay unlinked.
 
-For Bluesky accounts advertising `quote`, prepare the same publication with `quote: { protocol: 'bluesky', nativeId: sourceAtUri }`. The server resolves the exact source CID using each connected account, checks quote permission and Minds safety, and rechecks before writing. Review each delivery’s `quote` alongside the account and comment before submitting. Changed or unavailable sources cannot publish; uncertain deliveries reconcile the original record key. ActivityPub/Nostr quotes are not provided by this method. Public post reads include at most one filtered `quote` with `state: 'available'` and `post`, or `state: 'unavailable'` without source content. Available quotes may include `embeddedReferences`: exact standalone source-reference lines in the unchanged outer `text`. Omit them only when the quoted original is actually visible; retain them for unavailable or locally hidden quotes. Nostr references are decoded and matched by the server, without following relay hints.
+For Bluesky accounts advertising `quote`, prepare the same publication with `quote: { protocol: 'bluesky', nativeId: sourceAtUri }`. The server resolves the exact source CID using each connected account, checks quote permission and Minds safety, and rechecks before writing. Review each delivery’s `quote` alongside the account and comment before submitting. Changed or unavailable sources cannot publish; uncertain deliveries reconcile the original record key. Mastodon accounts advertising `quote` (0.7.71) take `quote: { protocol: 'activitypub', nativeId: statusUri }`: the member's server must create quote posts (Mastodon API version 7, sent as `quoted_status_id`) and allow this account to quote the status, or prepare answers `quote_not_supported` / `reply_not_allowed`, never a plain link. A Nostr quote is `prepareNativeNostr(identityId, { action: 'publish', content, quote: { protocol: 'nostr', nativeId: eventId } })` (accounts advertising `quote`): the event carries NIP-18 `q` and `p` tags and a `nostr:nevent` line after the text, for the member's signer to sign as usual. Public post reads include at most one filtered `quote` with `state: 'available'` and `post`, or `state: 'unavailable'` without source content. Available quotes may include `embeddedReferences`: exact standalone source-reference lines in the unchanged outer `text`. Omit them only when the quoted original is actually visible; retain them for unavailable or locally hidden quotes. Nostr references are decoded and matched by the server, without following relay hints.
 
 Topic browsing can request `getPublicTrends({ protocol: "bluesky", includePreviews: true })`. Optional `SocialTrend.preview` is a real image-bearing post from that topic, never a generated illustration. The server samples at most eight posts for each of ten topics, with three concurrent reads and a shared 2.5-second deadline; missing images leave usable text topics. App moderation and user source controls filter previews on every request. Bluesky CDN image attachments, quote-with-media images, and unlabeled link-preview thumbnails are supported; omitted content retains the source link.
 
@@ -654,8 +668,12 @@ authority and interactive controls. `retryFailed()` explicitly retries unavailab
 sources; create a new session to refresh exhausted source windows. A topics network
 (Bluesky) is read one topic page at a time; in a category the catalog's previews are not
 judged to be in it, so a read walks into the topics at once, and walks past a topic the
-provider no longer lists (`trend_unavailable`) or one with nothing in the category, up
-to five topic pages a read, so a page reaches a topic that carries posts. A network read
+provider no longer lists (`trend_unavailable`) or one with nothing new, up
+to five topic pages a read, so a page reaches a topic that carries posts. In a category a
+topic page that shows nothing new ends its topic (the provider's cursor is not followed),
+after three such pages in a row (`DISCOVERY_EMPTY_TOPIC_PAGES`) the network's other topics
+are passed over without a call, and the network's source-index stream (`idx:tf:` cursors)
+is started once and ends on its third page in a row with nothing new. A network read
 that fails for a passing reason (past the 15 s page deadline, a dropped connection, a 429
 or a 5xx) leaves the network out of that page and the next, named in `retryingSources`
 until a later page asks it again (from the page after, when its turn comes), up to two
@@ -671,6 +689,51 @@ and says whether the member is personalized yet (`meta.personalized`). With a
 `category` (the member's first), the session also reads open-network posts from it;
 without, it is Minds only. It never carries the radar.
 
+### Progressive Discover feed
+
+`sdk.discovery.createProgressiveFeed(options, settings?)` reads the same feed without
+waiting for its slowest network (a session's page waits for every source, up to 15 s). It
+opens one `createFeed` session per source (Minds with the story radar and suggestions, and
+one per network with `public_trends`), and `next(onPart)` hands each source's page on as a
+`DiscoveryPart` (`{ source, round, modules, composed?, mixed? }`) the moment it lands; the
+promise resolves with the round's summary (`hasMore`, `failedSources`, `retryingSources`,
+`fallover`) and rejects only when every source it read failed. A round waits
+`DISCOVERY_STRAGGLER_MS` (3 s) past its first answer; a source still reading then lands
+later, and `onStatus(listener)` says so. `setNetworks(catalog)` takes in a network the feed
+did not have (a feed opened before the catalog answered) and stops reading one the catalog
+dropped.
+
+The first load is held until Minds and one other network have answered, or
+`FIRST_SCREEN_MS` (2.5 s, a member's; pass `firstScreenMs: VISITOR_FIRST_SCREEN_MS`, 0.8 s,
+for a visitor) after the first answer, and arrives as one part with `composed: true`, built
+by `composeFirstScreen`:
+
+- it leads with the top's first post when that is a video that can play; else with a post
+  that opens on a picture or video (`moduleOpensOnPicture`) from the best
+  `FIRST_SCREEN_LEAD_WINDOW` (8) by engagement. A story, a suggestion rail, a video strip,
+  a conversation or thread (`isColumnModule`), a sensitive Minds post (`isSensitivePost`)
+  or an open-network post that links a porn site (`linksAdultSite`) never leads;
+- the posts then follow by engagement, every network's together (`DiscoveryEngagementMerge`:
+  normalised per network, decayed by age, video and pictures first, no network more than
+  8 of any 20 rows or 3 in a row, a Minds member's post at least every sixth row); posts by
+  `name@host` accounts in Minds' lane count as ActivityPub's (`mindsPostNetwork`);
+- the row under the lead is the best post from another network while one of the same standing
+  is left (`FIRST_SCREEN_NETWORK_ROWS`), so a screen that shows two rows is never one network's;
+- a story goes in as row 3 (`FIRST_SCREEN_STORY_SLOT`) and a rail as row 5
+  (`FIRST_SCREEN_RAIL_SLOT`); galleries are pooled into one; nothing is dropped.
+
+Later parts over every network carry `mixed: true`: merge them below what the reader has
+seen with `mergeDiscoveryArrival(rows, arriving, reachedIds)`. `top`, `seen`, `seenClusters`
+and `bucket` reach every session; the top is read once per open (one session token), and
+not asked again for five minutes after it answers 404. Settings: `perSource: false` keeps
+a feed that picks its own networks whole (For you: pass
+`{ createFeed: o => sdk.discovery.createPersonalFeed(o) }` to the standalone
+`createProgressiveFeed(factory, options, { perSource: false })`), `firstScreen: false` hands
+every part on as it lands, and `onLanded(source, failed)` reports each landing. A client
+that moves clips out of a composed part recomposes the rest with
+`composeFirstScreen([{ modules }], { keepLead: true })`. `withoutSeenItems` and
+`readFalloverSteps` are the rules the feed applies across sources and to `fallover`.
+
 ### For You: the world by the member's interests
 
 `sdk.curator.forYouWorld({ part?, session?, snapshot?, compass? })` reads the For You overview
@@ -716,11 +779,14 @@ its posts as soon as the radar answers, whatever the top does. When it answers,
 carries `top: { ref, position, block }`, a lane entry also `lane`), and its lanes stand in
 for the networks' first reads. Minds items the first hot page does not carry are read by id
 once, within the same 1.5 s (`top.post`, or `GET /posts/:id` without retries). `seen` (Minds post ids and
-`<protocol>/<nativeId>` refs the member already saw) leaves those posts out of the hot pages,
-and no hot page repeats a top item; a hot page left under five posts walks on, up to three
+`<protocol>/<nativeId>` refs the member already saw) leaves those posts out of the hot pages
+and out of the networks' trend pages, topic previews and topic pages (the top's own lanes
+stay), and no hot page repeats a top item; a hot page left under five posts walks on, up to three
 more pages, and the feed's `fallover` still reports when the ranking ends. Without impressions
-in the top's order, the member's seen top items follow the unseen ones. With no server lead,
-`seenClusters` (`Map<id, { n, clicked }>`) skips a story shown three times without an open,
+in the top's order, the member's seen top items follow the unseen ones. An item's
+`top.position` is its place in the whole top, so sessions that each place their own
+network's part never share a place. `seenClusters` (`Map<id, { n, clicked }>`) skips a story
+shown three times without an open, the server's lead included,
 and a visitor's `bucket` rotates page 0's story among the breaking ones
 (`pickRadarCluster` is the same rule on its own). With none of these options a session is
 unchanged.
@@ -743,6 +809,8 @@ a legislature, or a party or politician. Hide politics leaves those out whatever
 `feeds.top()` carry `political` too (0.7.67), and those reads and `curator.forYouWorld()` leave political stories out
 under Hide politics.
 
+Every story names one outlet count (0.7.71): radar stories, World Today stories, category strip stories, feed-top and search stories carry `outlets: { total, mainstream, independent, other }`, the distinct outlets of the articles the story lists (buckets sum to `total`). Show `outlets.total`; `sources.outlet` counts articles, not outlets.
+
 A World Today story's discussion across networks (0.7.69; servers with World Story Volume on): `sdk.curator.today()`
 gives each world story the server indexed a `story_key` and, when the reader's pool holds a post, a `discussion`:
 `total`, `people`, `by_network` (`minds`, `bluesky`, `activitypub`, `nostr`), `capped` (the pool reached 1,000: show

package/dist/client.d.ts

@@ -33,9 +33,14 @@ export declare class HttpClient {
     get<T>(path: string, params?: Record<string, unknown>, options?: {
         retry?: boolean;
     }): Promise<T>;
+    /**
+     * `keepalive: true` lets the request outlive the page (a page-leave flush): it is on the wire before this returns,
+     * and it is asked once, since no retry can run after the page is gone.
+     */
     post<T>(path: string, body?: unknown, options?: {
         retry?: boolean;
         idempotencyKey?: string;
+        keepalive?: boolean;
     }): Promise<T>;
     put<T>(path: string, body?: unknown, options?: {
         retry?: boolean;

package/dist/client.js

@@ -182,6 +182,10 @@ export class HttpClient {
         const response = await (options?.retry === false ? this.fetchWithTimeout(url, request) : this.fetchWithRetry(url, request));
         return this.handleResponse(response);
     }
+    /**
+     * `keepalive: true` lets the request outlive the page (a page-leave flush): it is on the wire before this returns,
+     * and it is asked once, since no retry can run after the page is gone.
+     */
     async post(path, body, options) {
         const url = this.buildUrl(path);
         const request = {
@@ -192,8 +196,10 @@ export class HttpClient {
                 ...(options?.idempotencyKey ? { 'Idempotency-Key': options.idempotencyKey } : {}),
             },
             body: body ? JSON.stringify(body) : undefined,
+            ...(options?.keepalive ? { keepalive: true } : {}),
         };
-        const response = await (options?.retry === false ? this.fetchWithTimeout(url, request) : this.fetchWithRetry(url, request));
+        const once = options?.retry === false || options?.keepalive === true;
+        const response = await (once ? this.fetchWithTimeout(url, request) : this.fetchWithRetry(url, request));
         return this.handleResponse(response);
     }
     async put(path, body, options) {

package/dist/index.d.ts

@@ -59,11 +59,13 @@ import { JobsResource } from './resources/jobs.js';
 import { CuratorResource } from './resources/curator.js';
 import { ReportsResource } from './resources/reports.js';
 import { ModerationResource } from './resources/moderation.js';
+import { JudgmentsResource } from './resources/judgments.js';
 import { LinkPreviewResource } from './resources/link-preview.js';
 import { SearchResource } from './resources/search.js';
 import { BookmarksResource } from './resources/bookmarks.js';
 import { FeedsResource } from './resources/feeds.js';
 import { AccountsResource } from './resources/accounts.js';
+import { SignalsResource } from './resources/signals.js';
 import { RealtimeClient } from './realtime.js';
 import type { RecursivConfig } from './types.js';
 export declare class Recursiv {
@@ -129,12 +131,16 @@ export declare class Recursiv {
     readonly boosts: BoostsResource;
     readonly reports: ReportsResource;
     readonly moderation: ModerationResource;
+    /** Jev's labels of a post: read them, dispute or appeal one, and (staff) review a dispute. */
+    readonly judgments: JudgmentsResource;
     readonly linkPreview: LinkPreviewResource;
     /** Blended search: posts, open network, people, groups, topics, stories, related and trending in one answer. */
     readonly search: SearchResource;
     /** Synced bookmarks: the member's saved posts, open-network posts and articles in this app, across devices. */
     readonly bookmarks: BookmarksResource;
     readonly accounts: AccountsResource;
+    /** The member's engagement signals (views, dwell, hides, "More like this") for their own ranking. */
+    readonly signals: SignalsResource;
     readonly realtime: RealtimeClient;
     constructor(config?: Partial<RecursivConfig>);
     /**
@@ -160,10 +166,10 @@ export { ChatResource } from './resources/chat.js';
 export { E2eeResource } from './resources/e2ee.js';
 export type { E2eeAccountReset, E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelope, E2eeEvent, E2eeHasDependentsDetails, E2eeKeyPackageStatus, E2eeLink, E2eeLinkCancelledBy, E2eeLinkProgress, E2eeLinkRealtimeEvent, E2eeLinkState, E2eeObjectDownload, E2eeObjectUpload, E2eeRealtimeEvent, E2eeResetCodeSent, E2eeResetErrorCode, E2eeRevokeResponse, E2eeStartRequest, E2eeStatus, E2eeStatusReason, } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
-export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
+export { AgentsResource, SUPPORTED_MODELS, AGENT_DIRECTORY_SORTS, AGENT_DIRECTORY_MAX_LIMIT } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';
 export type { EvidenceTarget, EvalType, CreateEvalInput, SimulateInput, SimulateResult, EvalRunRow, EvalResultRow, EvalRunDetail, EvidenceSummary, EvidenceEvent, EvidenceRecordDetail } from './resources/evidence.js';
-export type { AgentMessage, AgentMessageInput, AgentInboxParams, AgentAskInput, AgentAskResult, SupportedModel, SalesLead, SalesLeadListParams, SalesLeadStatus } from './resources/agents.js';
+export type { AgentMessage, AgentMessageInput, AgentInboxParams, AgentAskInput, AgentAskResult, SupportedModel, SalesLead, SalesLeadListParams, SalesLeadStatus, AgentDirectorySort, AgentDirectoryParams, AgentDirectoryEntry, AgentDirectoryMeta, AgentDirectoryPage } from './resources/agents.js';
 export { TagsResource } from './resources/tags.js';
 export { SandboxResource } from './resources/sandbox.js';
 export { ProfilesResource } from './resources/profiles.js';
@@ -199,6 +205,8 @@ export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, C
 export { STORY_POOL_MAX_POSTS, STORY_POST_NETWORKS, STORY_POSTS_PAGE_MAX } from './resources/curator.js';
 export { ReportsResource } from './resources/reports.js';
 export type { ReportTargetType, ReportStatus, CreateReportInput, ReportRecord, ResolveReportInput, } from './resources/reports.js';
+export { JudgmentsResource, isJudgmentSharedWordsError } from './resources/judgments.js';
+export type { JudgmentSubjectKind, JudgmentSource, JudgmentOverrideMethod, PostLabelsStatus, PostLabelsQuery, PostLabelsSubject, PostLabelsCategory, PostLabelsPolitics, PostJudgmentRecord, PostJudgment, PostSafetyAttribution, PostLabelsCategoryView, PostLabelsSummaryView, PostLabelsFullView, PostLabels, DisputeJudgmentInput, JudgmentDispute, ReviewJudgmentInput, JudgmentReviewUpheld, JudgmentReviewAwaitingReviewer, JudgmentReviewOverridden, JudgmentReview, JudgmentSharedWordsDetails, JudgmentSharedWordsError, } from './resources/judgments.js';
 export { ModerationResource } from './resources/moderation.js';
 export type { ModerationTargetType, ModerationActionType, ModerationAppealStatus, ModerationPrinciple, PublicModerationAction, PublicModerationLog, OwnModerationAppeal, OwnModerationAction, OwnModerationLog, ApplyModerationActionInput, AgentModerationMode, AgentModerationGrant, } from './resources/moderation.js';
 export { LinkPreviewResource } from './resources/link-preview.js';
@@ -209,6 +217,8 @@ export { FEED_TOP_NETWORKS, FeedsResource } from './resources/feeds.js';
 export type { FeedStoriesParams, FeedStoriesResponse, FeedStory, FeedTopExplain, FeedTopItem, FeedTopMeta, FeedTopNetwork, FeedTopNetworkCard, FeedTopNetworkEntry, FeedTopParams, FeedTopResponse, FeedTopTarget, PublicFeedTopMeta, PublicFeedTopParams, PublicFeedTopResponse, } from './resources/feeds.js';
 export type { BookmarkCollection, BookmarkCollectionInput, BookmarkCollectionKind, BookmarkCollectionPatch, BookmarkCollectionsList, BookmarkCollectionTarget, BookmarkCollectionVisibility, BookmarkedPost, BookmarkInput, BookmarkItem, BookmarkKey, BookmarkKeyRow, BookmarkKeysPage, BookmarkKind, BookmarkMergeItem, BookmarkMergeResult, BookmarkProtocol, BookmarkRequestOptions, BookmarksPage, FiledBookmark, RemovedBookmarkCollection, SavedBookmark, UnfiledBookmark, UnsavedBookmark, } from './resources/bookmarks.js';
 export { AccountsResource } from './resources/accounts.js';
+export { SIGNAL_BATCH_MAX, SignalsResource } from './resources/signals.js';
+export type { SignalBatchResult, SignalEventInput, SignalEventType, SignalNotRecordedReason, SignalRecordResult, SignalSendOptions, } from './resources/signals.js';
 export type { SiblingAccount, SiblingAccountsResponse, SwitchAccountResult, } from './resources/accounts.js';
 export type { LinkPreview, LinkPreviewResponse, } from './resources/link-preview.js';
 export type { AgentCapabilityConsentRequirement, AgentCapabilityDataSensitivity, AgentCapabilityDomain, AgentCapabilityExportBoundary, AgentCapabilityRetentionClass, AgentCapabilitySubdomain, AgentCapabilitySubject, AgentCapabilityTrustTier, AgentToolAudience, AgentToolScope, BrowserUseRunTaskInput, ProjectBrainSettings, ProjectToolBundleClassification, ProjectToolBundleKey, ProjectToolPermission, ProjectToolPermissionOverrides, UpdateProjectSettingsInput, } from './resources/project-brain.js';
@@ -223,7 +233,7 @@ export { BoostsResource } from './resources/boosts.js';
 export type { BoostBalance, BoostBalanceResponse, BoostCampaign, BoostCampaignResponse, BoostEventResult, BoostLedgerEntry, BoostLedgerKind, BoostPlanCredit, BoostRejectionReason, BoostReviewStatus, BoostStatus, BoostTopupCheckout, BoostTopupConfirmation, BoostTopupLimits, } from './resources/boosts.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, viralItemHasVideo, } from './resources/protocols.js';
-export type { SocialProfile, SocialBridge, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarPosts, SocialRadarStory, SocialRadarStoryArchive, ViralBaseline, ViralItem, ViralItemFields, ViralItemSpread, ViralItemVelocity, ViralLabel, ViralMindsCard, ViralMindsItem, ViralNetwork, ViralOpenProtocol, ViralProtocol, ViralProvider, ViralReadMeta, ViralReadParams, ViralReadResponse, ViralReadStatus, ViralRef, ViralSocialItem, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendSourceIndex, SocialTrendFeed, SocialPopularProfiles, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, SearchPublicPostsParams, SocialPostSearch, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeSocialCallbackInput, NativeReplyPrepareInput, NativePostPrepareInput, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostHistory, NativeDelegatedPostHistoryItem, NativeNostrPostHistoryItem, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowAccount, NativeFollowStates, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlDisplay, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, CreateHostedIdentityInput, CreatedHostedProtocolIdentity, PreviewHostedPostInput, PublishHostedPostInput, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolIngestionReplayResult, ProtocolIngestionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, ReplayProtocolIngestionJobInput, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
+export type { SocialProfile, SocialBridge, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarPosts, SocialRadarStory, SocialRadarStoryArchive, ViralBaseline, ViralItem, ViralItemFields, ViralItemSpread, ViralItemVelocity, ViralLabel, ViralMindsCard, ViralMindsItem, ViralNetwork, ViralOpenProtocol, ViralProtocol, ViralProvider, ViralReadMeta, ViralReadParams, ViralReadResponse, ViralReadStatus, ViralRef, ViralSocialItem, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendSourceIndex, SocialTrendFeed, SocialPopularProfiles, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, SearchPublicPostsParams, SocialPostSearch, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeSocialCallbackInput, NativeReplyPrepareInput, NativePostPrepareInput, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostQuote, NativePostHistory, NativeDelegatedPostHistoryItem, NativeNostrPostHistoryItem, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowAccount, NativeFollowStates, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlDisplay, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, CreateHostedIdentityInput, CreatedHostedProtocolIdentity, PreviewHostedPostInput, PublishHostedPostInput, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolIngestionActivityReason, ProtocolIngestionCircuitHealth, ProtocolIngestionDeadLetterGroup, ProtocolIngestionHealthPosition, ProtocolIngestionHealthReport, ProtocolIngestionHealthRuntime, ProtocolIngestionHealthSection, ProtocolIngestionLaneActivity, ProtocolIngestionLaneCurrentJob, ProtocolIngestionLaneDeadLetters, ProtocolIngestionLaneHealth, ProtocolIngestionLaneJobs, ProtocolIngestionReplayResult, ProtocolIngestionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, ReplayProtocolIngestionJobInput, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';

package/dist/index.js

@@ -60,11 +60,13 @@ import { JobsResource } from './resources/jobs.js';
 import { CuratorResource } from './resources/curator.js';
 import { ReportsResource } from './resources/reports.js';
 import { ModerationResource } from './resources/moderation.js';
+import { JudgmentsResource } from './resources/judgments.js';
 import { LinkPreviewResource } from './resources/link-preview.js';
 import { SearchResource } from './resources/search.js';
 import { BookmarksResource } from './resources/bookmarks.js';
 import { FeedsResource } from './resources/feeds.js';
 import { AccountsResource } from './resources/accounts.js';
+import { SignalsResource } from './resources/signals.js';
 import { RealtimeClient } from './realtime.js';
 export class Recursiv {
     /** Shared transport, kept so the client name can be set after construction. */
@@ -130,12 +132,16 @@ export class Recursiv {
     boosts;
     reports;
     moderation;
+    /** Jev's labels of a post: read them, dispute or appeal one, and (staff) review a dispute. */
+    judgments;
     linkPreview;
     /** Blended search: posts, open network, people, groups, topics, stories, related and trending in one answer. */
     search;
     /** Synced bookmarks: the member's saved posts, open-network posts and articles in this app, across devices. */
     bookmarks;
     accounts;
+    /** The member's engagement signals (views, dwell, hides, "More like this") for their own ranking. */
+    signals;
     realtime;
     constructor(config) {
         const client = new HttpClient(config);
@@ -198,10 +204,12 @@ export class Recursiv {
         this.boosts = new BoostsResource(client);
         this.reports = new ReportsResource(client);
         this.moderation = new ModerationResource(client);
+        this.judgments = new JudgmentsResource(client);
         this.linkPreview = new LinkPreviewResource(client);
         this.search = new SearchResource(client);
         this.bookmarks = new BookmarksResource(client);
         this.accounts = new AccountsResource(client);
+        this.signals = new SignalsResource(client);
         this.realtime = new RealtimeClient(client);
         this.#http = client;
     }
@@ -227,7 +235,7 @@ export { CommunitiesResource } from './resources/communities.js';
 export { ChatResource } from './resources/chat.js';
 export { E2eeResource } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
-export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
+export { AgentsResource, SUPPORTED_MODELS, AGENT_DIRECTORY_SORTS, AGENT_DIRECTORY_MAX_LIMIT } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';
 export { TagsResource } from './resources/tags.js';
 export { SandboxResource } from './resources/sandbox.js';
@@ -255,12 +263,14 @@ export { VideoResource } from './resources/video.js';
 export { AppSubscriptionsResource } from './resources/app-subscriptions.js';
 export { STORY_POOL_MAX_POSTS, STORY_POST_NETWORKS, STORY_POSTS_PAGE_MAX } from './resources/curator.js';
 export { ReportsResource } from './resources/reports.js';
+export { JudgmentsResource, isJudgmentSharedWordsError } from './resources/judgments.js';
 export { ModerationResource } from './resources/moderation.js';
 export { LinkPreviewResource } from './resources/link-preview.js';
 export { SEARCH_SECTIONS, SearchResource } from './resources/search.js';
 export { BOOKMARK_MERGE_MAX_ITEMS, BookmarkCollectionsResource, BookmarksResource } from './resources/bookmarks.js';
 export { FEED_TOP_NETWORKS, FeedsResource } from './resources/feeds.js';
 export { AccountsResource } from './resources/accounts.js';
+export { SIGNAL_BATCH_MAX, SignalsResource } from './resources/signals.js';
 export { OrganizationSettingsResource } from './resources/organization-settings.js';
 export { ProjectSettingsResource } from './resources/project-settings.js';
 export { OrganizationSecurityResource } from './resources/organization-security.js';

package/dist/resources/agents.d.ts

@@ -91,6 +91,44 @@ export interface AgentAskResult {
 export interface AgentLeaderboardParams extends PaginationParams {
     organization_id?: string;
 }
+/** The orders the agent directory serves (server: features/agents/agentDirectory.ts). */
+export declare const AGENT_DIRECTORY_SORTS: readonly ["popular", "recent", "name"];
+export type AgentDirectorySort = (typeof AGENT_DIRECTORY_SORTS)[number];
+/** The most agents one directory page holds. */
+export declare const AGENT_DIRECTORY_MAX_LIMIT = 50;
+export interface AgentDirectoryParams {
+    /** Words to find in an agent's name, handle (with or without its @) or description, case aside. */
+    q?: string;
+    /** popular (default): official and curated agents, then most followers. recent: newest first. name: A to Z. */
+    sort?: AgentDirectorySort;
+    /** The previous page's `meta.next_cursor`, for the same sort. */
+    cursor?: string;
+    /** 1 to 50, default 20. */
+    limit?: number;
+}
+/** One agent the app publishes, as the directory lists it. */
+export interface AgentDirectoryEntry {
+    id: string;
+    name: string;
+    username: string | null;
+    image: string | null;
+    bio: string | null;
+    follower_count: number;
+    /** An account the operator vouches for, as people rows carry it. */
+    verified: boolean;
+    created_at: string;
+}
+export interface AgentDirectoryMeta {
+    limit: number;
+    sort: AgentDirectorySort;
+    /** Where the next page starts, or null on the last page. */
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export interface AgentDirectoryPage {
+    data: AgentDirectoryEntry[];
+    meta: AgentDirectoryMeta;
+}
 export type SalesLeadStatus = 'new' | 'contacted' | 'engaged' | 'meeting' | 'won' | 'lost' | 'declined' | 'stale' | 'unsubscribed';
 export interface SalesLeadListParams {
     /** Server-side filter preset. Mirrors the agent's own sales_lead_list presets. */
@@ -223,6 +261,16 @@ export declare class AgentsResource {
         global?: boolean;
         include_global?: boolean;
     }): Promise<PaginatedResponse<Agent>>;
+    /**
+     * Search and sort the agents the app publishes: its Discover Agents page. The server searches (`q` in the name,
+     * handle or description) and orders (`popular`, `recent`, `name`); page with `meta.next_cursor`. Never lists a
+     * personal agent, a project's Lead or workers, a simulator bot, another company's unpublished agent, an agent its
+     * organization keeps private, one that is not public, or one wearing an official account's name (so a page can
+     * hold fewer than `limit`; keep paging while `next_cursor` is set). Works keyless for a signed-out visitor: build
+     * the client with `new Recursiv({ anonymous: true, inheritEnvironmentApiKey: false })` on the app's API host (the
+     * host names the network; public profiles only, 60 reads per IP a minute). With an app key it is that app's list.
+     */
+    discover(params?: AgentDirectoryParams): Promise<AgentDirectoryPage>;
     /**
      * Find-or-create the calling user's personal agent. Platform
      * primitive for apps that want to give every user an auto-provisioned

package/dist/resources/agents.js

@@ -1,5 +1,10 @@
 import { RecursivError } from '../errors.js';
 import { parseSSE } from '../lib/sse.js';
+// ── Agent directory (GET /agents/discover) ──
+/** The orders the agent directory serves (server: features/agents/agentDirectory.ts). */
+export const AGENT_DIRECTORY_SORTS = ['popular', 'recent', 'name'];
+/** The most agents one directory page holds. */
+export const AGENT_DIRECTORY_MAX_LIMIT = 50;
 // ── Supported models ──
 /**
  * Model identifiers the Recursiv platform currently accepts for agent
@@ -109,6 +114,23 @@ export class AgentsResource {
     listDiscoverable(params) {
         return this.client.get('/agents/discoverable', params);
     }
+    /**
+     * Search and sort the agents the app publishes: its Discover Agents page. The server searches (`q` in the name,
+     * handle or description) and orders (`popular`, `recent`, `name`); page with `meta.next_cursor`. Never lists a
+     * personal agent, a project's Lead or workers, a simulator bot, another company's unpublished agent, an agent its
+     * organization keeps private, one that is not public, or one wearing an official account's name (so a page can
+     * hold fewer than `limit`; keep paging while `next_cursor` is set). Works keyless for a signed-out visitor: build
+     * the client with `new Recursiv({ anonymous: true, inheritEnvironmentApiKey: false })` on the app's API host (the
+     * host names the network; public profiles only, 60 reads per IP a minute). With an app key it is that app's list.
+     */
+    discover(params = {}) {
+        return this.client.get('/agents/discover', {
+            q: params.q,
+            sort: params.sort,
+            cursor: params.cursor,
+            limit: params.limit,
+        });
+    }
     /**
      * Find-or-create the calling user's personal agent. Platform
      * primitive for apps that want to give every user an auto-provisioned

package/dist/resources/curator.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { CompassFilterMeta, DiscoveryLayout, PaginatedResponse, PaginationMeta, Post, SingleResponse } from '../types.js';
+import type { CompassFilterMeta, DiscoveryLayout, PaginatedResponse, PaginationMeta, Post, SingleResponse, StoryOutlets } from '../types.js';
 import type { FeedTopNetworkCard, FeedTopTarget } from './feeds.js';
 import type { SocialPost } from './protocols.js';
 /** Which surface is asking: Home's For You (default) or Discover's For you. */
@@ -355,9 +355,15 @@ export interface CuratorTodayStory {
     political?: boolean;
     /** Outlet links for a world story; null for a Minds story. */
     sources: CuratorTodaySource[] | null;
-    /** Distinct outlets behind a world story; null for a Minds story. */
+    /**
+     * How many outlets reported a world story, by lane (StoryOutlets, 0.7.71): the radar story's own when the story seeded
+     * one, so the card names the number its story page, the radar and the News section name. Null for a Minds story;
+     * absent from an older server.
+     */
+    outlets?: StoryOutlets | null;
+    /** Distinct outlets behind a world story (`outlets.total` from 0.7.71's servers); null for a Minds story. */
     outlet_count: number | null;
-    /** Distinct outlets per lane behind a world story; null for a Minds story. */
+    /** Distinct outlets per lane behind a world story (`outlets`' two lanes from 0.7.71's servers); null for a Minds story. */
     lane_mix: CuratorTodayLaneMix | null;
     /**
      * Which lanes carry a world story: 'mainstream', 'independent' (nobody in

package/dist/resources/discovery-fallover.d.ts

@@ -0,0 +1,8 @@
+import type { FalloverStep } from '../types.js';
+/**
+ * A feed page's fall-through (the Minds read's `meta.fallover`, or a session page's `fallover`), step by step. A step of a kind this SDK knows (`feed` included, 0.7.60) that carries
+ * the fields its kind declares is kept as the server sent it; a step of a kind a later server added, or a malformed
+ * one, is left out and never guessed at, so every step a page reports is a FalloverStep. Undefined when the page has
+ * no list (a server before the contract, or a feed that is not a category's).
+ */
+export declare function readFalloverSteps(value: unknown): FalloverStep[] | undefined;

package/dist/resources/discovery-fallover.js

@@ -0,0 +1,26 @@
+const FALLOVER_VIA = new Set(['personal', 'popular', 'static']);
+const filled = (value) => typeof value === 'string' && value.length > 0;
+/**
+ * A feed page's fall-through (the Minds read's `meta.fallover`, or a session page's `fallover`), step by step. A step of a kind this SDK knows (`feed` included, 0.7.60) that carries
+ * the fields its kind declares is kept as the server sent it; a step of a kind a later server added, or a malformed
+ * one, is left out and never guessed at, so every step a page reports is a FalloverStep. Undefined when the page has
+ * no list (a server before the contract, or a feed that is not a category's).
+ */
+export function readFalloverSteps(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    return value.filter((raw) => {
+        if (!raw || typeof raw !== 'object')
+            return false;
+        const step = raw;
+        switch (step.kind) {
+            case 'category_older': return filled(step.category) && filled(step.cursor);
+            case 'category_network': return filled(step.category);
+            case 'category': return filled(step.category) && typeof step.via === 'string' && FALLOVER_VIA.has(step.via);
+            case 'for_you':
+            case 'all': return true;
+            case 'feed': return filled(step.ref);
+            default: return false;
+        }
+    });
+}

package/dist/resources/discovery-first-screen.d.ts

@@ -0,0 +1,30 @@
+import type { DiscoveryModule } from './discovery.js';
+/** The row a story takes when there are posts enough above it: under the lead and one other post. */
+export declare const FIRST_SCREEN_STORY_SLOT = 2;
+/** The row a suggestion rail takes. */
+export declare const FIRST_SCREEN_RAIL_SLOT = 4;
+/** How far down the screen's engagement order a post may be and still lead it for its picture: about one screen. */
+export declare const FIRST_SCREEN_LEAD_WINDOW = 8;
+/** The first row a column of several posts (a conversation, a thread) may take. */
+export declare const FIRST_SCREEN_FEATURE_SLOT = 3;
+/** The first rows that each come from a network no row above them does, while the screen has one: the lead and the row under it. */
+export declare const FIRST_SCREEN_NETWORK_ROWS = 2;
+/**
+ * A module that opens on a picture or a video: one post that shows one, or a gallery whose first card does. A column
+ * of posts whose picture is further down opens on text, and a video strip is not a post's picture.
+ */
+export declare function moduleOpensOnPicture(module: DiscoveryModule): boolean;
+/** The top's first post (the smallest place among the modules), when it is a video that can play: it leads the screen. */
+export declare function discoveryTopVideoLead(modules: readonly DiscoveryModule[]): DiscoveryModule | undefined;
+/**
+ * The first screen's modules, from the parts that landed (in landing order), in the order described above. Pure for a
+ * given `now` (the time the posts' ages are counted to): the same parts give the same screen.
+ * `keepLead`: the parts' first module is the lead already (a composed screen a client recomposes after moving its
+ * clips into a strip of its own).
+ */
+export declare function composeFirstScreen(parts: ReadonlyArray<{
+    modules: readonly DiscoveryModule[];
+}>, { keepLead, now }?: {
+    keepLead?: boolean;
+    now?: number;
+}): DiscoveryModule[];