@recursiv/sdk 0.7.57 → 0.7.58

package/README.md

@@ -75,7 +75,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | Resource | Key methods |
 |----------|------------|
 | `r.agents` | `create`, `update`, `chat`, `chatStream`, `retryChatStream`, `grantProjectAccess`, `conversations` |
-| `r.e2ee` | `status`, `registerDevice`, `devices`, `revokeDevice`, `publishKeyPackages`, `keyPackageStatus`, `claimKeyPackage`, `appendEvent`, `events`, `acknowledge`, `conversations`; 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.e2ee` | `status`, `registerDevice`, `devices`, `revokeDevice` (`{ cascade }` to also revoke devices approved through it; 409 `has_dependents` otherwise), `publishKeyPackages`, `keyPackageStatus`, `claimKeyPackage`, `appendEvent`, `events`, `acknowledge`, `conversations`; 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` |
 | `r.projectBrain` | `tasks`, `decisions`, `milestones`, `completeTask`, `usage` |
@@ -115,7 +115,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.admin` | User management, stats, content reports (`listReports`, `resolveReport`, `dismissReport`) |
 | `r.dispatcher` | Task queue, claims, signals, outcomes, webhooks |
 | `r.goals` | Org goals with task rollups (group dispatcher tasks) |
-| `r.protocols` | Private Minds safety: `sourceControls` (current enablement and saved choices; filter with `control`, each item may carry a `display` label), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `nativeFollowStates` (every connected account's state for one source, one read), `nativeFollowState`, `prepareNativeFollow`, `submitNativeFollow`, `nativeFollowStatus` (native following or pending approval, distinct from a Minds feed subscription; preserve the complete signed Nostr list). Native reposts and undo: `nativeRepostState`, `prepareNativeRepost`, `submitNativeRepost`, `nativeRepostStatus` (public posts, explicit approval, connected account, no uncertain retries). Native likes and unlikes: `nativeLikeState`, `prepareNativeLike`, `submitNativeLike`, `nativeLikeStatus` (connected authority, app enablement and explicit approval; resume pending actions instead of duplicating them). Reviewed replies and optional linked posts: `prepareNativeReply`, `submitNativeReply`, `nativeReplyStatus`, `nativeReplyHistory`, `prepareNativeReplyRemoval`, `removeNativeReply` (require deployed API support and app enablement). Keyless shared post links: `sharedNetworks(projectId)`, `getSharedConversation(projectId, { protocol, post, readRef? })`. Member public reading: `searchPublicPosts` (selected account required for Bluesky/ActivityPub; public Nostr search), `getConnectedSocialConversation` (preserve result readerAccountId/readRef), `publicNetworks`, `searchPublicProfiles`, `getPublicProfile`, `getPublicAuthorFeed`, `getFollowingFeed`, `getPublicConversation`, `getPublicTrends`, `getPublicTrendFeed`; radar stories: `getPublicRadarStory` (one story by id with its posts; one that has left the radar comes with its archived copy and the live story it continues as; the id may be a World Today edition story's, and the answer then names it in `editionStory` under the story's radar id), keyless `getSharedRadarStory(projectId, { cluster })` and `getSharedRadarPosts(projectId, { cluster })` (keyless reads carry images and videos only from outlets and members marked `visitorMedia`; signed-in reads keep all media, so a share card uses only those); private app subscriptions: `listSubscriptions`, `subscribeToProfile`, `unsubscribeFromProfile`, `onSubscriptionChange`. `list` returns bounded adapter `maturity`, `limitations`, and exhaustive `supported`/`planned`/`unsupported` implementation capabilities (not provider health or enablement); settings, candidate refresh/status, search, and read-only quarantined candidate review via `listCandidates` / `getCandidate` |
+| `r.protocols` | Private Minds safety: `sourceControls` (current enablement and saved choices; filter with `control`, each item may carry a `display` label), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `nativeFollowStates` (every connected account's state for one source, one read), `nativeFollowState`, `prepareNativeFollow`, `submitNativeFollow`, `nativeFollowStatus` (native following or pending approval, distinct from a Minds feed subscription; preserve the complete signed Nostr list). Native reposts and undo: `nativeRepostState`, `prepareNativeRepost`, `submitNativeRepost`, `nativeRepostStatus` (public posts, explicit approval, connected account, no uncertain retries). Native likes and unlikes: `nativeLikeState`, `prepareNativeLike`, `submitNativeLike`, `nativeLikeStatus` (connected authority, app enablement and explicit approval; resume pending actions instead of duplicating them). Reviewed replies and optional linked posts: `prepareNativeReply`, `submitNativeReply`, `nativeReplyStatus`, `nativeReplyHistory`, `prepareNativeReplyRemoval`, `removeNativeReply` (require deployed API support and app enablement). Keyless shared post links: `sharedNetworks(projectId)`, `getSharedConversation(projectId, { protocol, post, readRef? })`. Member public reading: `searchPublicPosts` (selected account required for Bluesky/ActivityPub; public Nostr search), `getConnectedSocialConversation` (preserve result readerAccountId/readRef), `publicNetworks`, `searchPublicProfiles`, `getPublicProfile`, `getPublicAuthorFeed`, `getFollowingFeed`, `getPublicConversation`, `getPublicTrends`, `getPublicTrendFeed`; radar stories: `getPublicRadarStory` (one story by id with its posts; one that left the radar within its minimum lifetime, or within the last half hour, still answers live with `liveUntil` and the story that continues it; one that has left for longer comes with its archived copy and the live story it continues as; the id may be a World Today edition story's, and the answer then names it in `editionStory` under the story's radar id), keyless `getSharedRadarStory(projectId, { cluster })` and `getSharedRadarPosts(projectId, { cluster })` (keyless reads carry images and videos only from outlets and members marked `visitorMedia`; signed-in reads keep all media, so a share card uses only those); private app subscriptions: `listSubscriptions`, `subscribeToProfile`, `unsubscribeFromProfile`, `onSubscriptionChange`. `list` returns bounded adapter `maturity`, `limitations`, and exhaustive `supported`/`planned`/`unsupported` implementation capabilities (not provider health or enablement); settings, candidate refresh/status, search, and read-only quarantined candidate review via `listCandidates` / `getCandidate` |
 
 Full reference: see [llm.md](./llm.md) (ships with this package) or the type definitions in `dist/`.
 

package/dist/index.d.ts

@@ -154,7 +154,7 @@ export { UsersResource } from './resources/users.js';
 export { CommunitiesResource } from './resources/communities.js';
 export { ChatResource } from './resources/chat.js';
 export { E2eeResource } from './resources/e2ee.js';
-export type { E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelope, E2eeEvent, E2eeKeyPackageStatus, E2eeLink, E2eeLinkCancelledBy, E2eeLinkProgress, E2eeLinkRealtimeEvent, E2eeLinkState, E2eeObjectDownload, E2eeObjectUpload, E2eeRealtimeEvent, E2eeStatus, E2eeStatusReason, } from './resources/e2ee.js';
+export type { E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelope, E2eeEvent, E2eeHasDependentsDetails, E2eeKeyPackageStatus, E2eeLink, E2eeLinkCancelledBy, E2eeLinkProgress, E2eeLinkRealtimeEvent, E2eeLinkState, E2eeObjectDownload, E2eeObjectUpload, E2eeRealtimeEvent, E2eeRevokeResponse, E2eeStatus, E2eeStatusReason, } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
 export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';

package/dist/resources/e2ee.d.ts

@@ -163,6 +163,23 @@ export interface E2eeLinkRealtimeEvent {
     linkId: string;
     state: 'scanned' | 'approved' | 'completed' | 'progress' | 'cancelled';
 }
+/**
+ * The `details` of a 409 `has_dependents` refusal from `revokeDevice` (read
+ * them from the thrown `ConflictError`'s `details`): the ids of the account's
+ * active devices that were approved through the device and would stop
+ * working with it, and whether it is the account's root (main) device, which
+ * every device chains to; once the root is revoked the account cannot link a
+ * new device.
+ */
+export interface E2eeHasDependentsDetails {
+    dependents: string[];
+    root: boolean;
+}
+/** `revokeDevice`'s answer: the device, and every device the call revoked (the target first). */
+export interface E2eeRevokeResponse extends SingleResponse<E2eeDevice> {
+    /** Absent on relays before 0.7.58. Empty when the device was already revoked and nothing else was. */
+    revoked?: string[];
+}
 /**
  * The realtime `e2ee:devices` event (`r.realtime.onE2eeDevices`): `packages`
  * when one of the account's devices can now be claimed (it published after
@@ -203,7 +220,18 @@ export declare class E2eeResource {
     }): Promise<{
         data: E2eeDevice[];
     }>;
-    revokeDevice(deviceId: string): Promise<SingleResponse<E2eeDevice>>;
+    /**
+     * Revoke one of your devices. When other active devices were approved
+     * through it, or it is the account's root (main) device, the relay changes
+     * nothing and throws a `ConflictError` with code `has_dependents` and
+     * `details: E2eeHasDependentsDetails`, so the app can say which devices
+     * would be signed out. Call again with `{ cascade: true }` to revoke it and
+     * every device chained through it (relays from 0.7.58; older relays ignore
+     * the body and revoke only the device).
+     */
+    revokeDevice(deviceId: string, input?: {
+        cascade?: boolean;
+    }): Promise<E2eeRevokeResponse>;
     /** Publish one-time key packages for one of your devices; `available` is how many it now has. */
     publishKeyPackages(input: {
         device_id: string;

package/dist/resources/e2ee.js

@@ -28,8 +28,17 @@ export class E2eeResource {
     devices(params) {
         return this.client.get('/e2ee/devices', params);
     }
-    revokeDevice(deviceId) {
-        return this.client.post(`/e2ee/devices/${encodeURIComponent(deviceId)}/revoke`);
+    /**
+     * Revoke one of your devices. When other active devices were approved
+     * through it, or it is the account's root (main) device, the relay changes
+     * nothing and throws a `ConflictError` with code `has_dependents` and
+     * `details: E2eeHasDependentsDetails`, so the app can say which devices
+     * would be signed out. Call again with `{ cascade: true }` to revoke it and
+     * every device chained through it (relays from 0.7.58; older relays ignore
+     * the body and revoke only the device).
+     */
+    revokeDevice(deviceId, input) {
+        return this.client.post(`/e2ee/devices/${encodeURIComponent(deviceId)}/revoke`, input ?? {});
     }
     /** Publish one-time key packages for one of your devices; `available` is how many it now has. */
     publishKeyPackages(input) {

package/dist/resources/protocols.d.ts

@@ -990,7 +990,10 @@ export interface SocialPost {
      * older than 15 minutes when the provider answers in time). Absent: the counts are from this read.
      */
     countsObservedAt?: string;
-    /** Pixel dimensions when the source declares them (Bluesky aspect ratio, Mastodon attachment meta), so a card can take the clip's shape before it loads. */
+    /**
+     * Pixel dimensions when the source declares them (Bluesky aspect ratio, Mastodon attachment meta, Nostr NIP-92 `dim`), so a
+     * card can take the clip's shape before it loads. Each entry of a sensitive post carries `sensitive: true`.
+     */
     media: Array<{
         type: 'image' | 'video';
         url: string;
@@ -998,8 +1001,15 @@ export interface SocialPost {
         poster?: string;
         width?: number;
         height?: number;
+        sensitive?: true;
     }>;
     hasAdditionalContent: boolean;
+    /**
+     * The author marked the post sensitive with one of Minds' sensitive tags (#nsfw, #nudity and the rest), in its text or
+     * among the network's own tags: cover its media as a Minds post flagged NSFW is covered. A post the network itself marks
+     * (a Mastodon sensitive flag or content warning, a Bluesky label, a Nostr content-warning) is never returned at all.
+     */
+    sensitive?: boolean;
     /** At most one independently filtered quoted post. */
     quote?: {
         state: 'available';
@@ -1152,7 +1162,11 @@ export interface SocialRadarMember {
      */
     visitorMedia?: true;
 }
-/** One story on the radar. `breaking` is outlet corroboration inside a short window; `viral` is social velocity above its network's norm. */
+/**
+ * One story on the radar. `breaking` is outlet corroboration inside a short window; `viral` is social velocity above its
+ * network's norm, from two or more people, on a story still gaining engagement, reported by no outlet or by two or more.
+ * `velocity.perHour` is the engagement its posts gained per hour since the last build, counting only posts read on both.
+ */
 export interface SocialRadarCluster {
     id: string;
     /** Verbatim: a World Today headline, a provider topic name or the medoid outlet title. Never generated. */
@@ -1249,7 +1263,9 @@ export interface SocialRadarStoryArchive {
 }
 /**
  * One radar story by id, with its social member posts.
- * `live`: on the current radar (`cluster` and `items` present). `aged_out`: not on this radar, but
+ * `live`: on the current radar (`cluster` and `items` present), or left it sooner than its minimum lifetime after it was
+ * first published (six hours by default), or within the last half hour: then `liveUntil` says until when, and `successor`
+ * names the story on the radar that continues it, if one does. `aged_out`: not on this radar, but
  * held by the story archive (`archive`, and the live story it continues as in `successor`) or seen on
  * one of the last six radars (`archive` null). `unknown`: in neither (never existed, or left longer ago
  * than the archive keeps stories). A server without the story archive leaves `archive` and `successor` out.
@@ -1266,6 +1282,8 @@ export interface SocialRadarStory {
         id: string;
         label: string;
     } | null;
+    /** On a `live` answer for a story no longer on the radar list: when it stops answering `live` and ages out. */
+    liveUntil?: string;
     /**
      * Present when the story was asked for by a World Today edition story's id: the radar story that edition story
      * seeded, and `id` is its radar id, the address to link to. A server that cannot resolve edition story ids answers 400.
@@ -1302,6 +1320,13 @@ export interface SocialConversation {
     replies: SocialPost[];
     coverage: 'public_provider_window';
     limited: boolean;
+    /**
+     * The member hid this post, or blocks or mutes its author: `focus` is the post, so the app can show it on request,
+     * `replies` is empty, and `viewerControls` are the member's controls to undo. Absent otherwise (a post the app's
+     * moderation withholds is `post_unavailable`).
+     */
+    hiddenByViewer?: true;
+    viewerControls?: Array<Pick<SocialSourceControl, 'source' | 'control'>>;
 }
 export interface SocialFollowingSource {
     subscriptionId: string;

package/dist/resources/search.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { Post } from '../types.js';
+import type { Post, ViewerModeration } from '../types.js';
 import type { SocialPost } from './protocols.js';
 /** The sections a blended search can answer, in no particular order (see `SearchAnswer.order`). */
 export declare const SEARCH_SECTIONS: readonly ["top_posts", "latest_posts", "open_network", "people", "groups", "topics", "stories", "related", "trending"];
@@ -34,6 +34,14 @@ export interface SearchPerson {
     plus: boolean;
     pro: boolean;
     founder: boolean;
+    /**
+     * The account wears the display name of a verified or founder account it is not: it is listed after every account
+     * that is not such a copy. Label it as not the account at `name_matches_verified_handle`. Absent from an older API.
+     */
+    name_matches_verified?: boolean;
+    name_matches_verified_handle?: string | null;
+    /** Whether the caller mutes this account (people search never lists an account in a block with the caller). */
+    viewer?: ViewerModeration;
 }
 export interface SearchGroup {
     id: string;

package/dist/types.d.ts

@@ -118,6 +118,12 @@ export interface UserSummary {
     username: string;
     image: string | null;
     is_ai: boolean;
+    /**
+     * The account labels itself adult by its own handle, display name or bio:
+     * cover its avatar unless the member turned Show NSFW on. Absent from
+     * servers older than this field and from reads that do not label accounts.
+     */
+    is_nsfw?: boolean;
 }
 export interface User extends UserSummary {
     bio: string | null;
@@ -254,11 +260,24 @@ export interface RepostedPost {
     media: MediaItem[];
     created_at: string;
 }
+/**
+ * What the signed-in caller has done about an account: they block it, they mute it. Never what the account did about
+ * the caller. Absent when the server could not read it, and from an older API.
+ */
+export interface ViewerModeration {
+    blocking: boolean;
+    muting: boolean;
+}
 export interface PostDetail extends Post {
     /** The newest replies (at most 50). */
     replies: PostReply[];
     /** Present when the thread has more replies; pass it to `posts.replies(id, { cursor })` for the next, older page. */
     replies_next_cursor?: string | null;
+    /**
+     * Whether the caller blocks or mutes the author, so a page can say "You blocked @x" (with View and Unblock) instead
+     * of offering a reply or a vote: reacting to or replying to a post across a block answers 403.
+     */
+    viewer?: ViewerModeration;
 }
 export interface PostReply {
     id: string;
@@ -514,6 +533,12 @@ export interface CommunityMember {
     image: string | null;
     bio: string | null;
     is_ai: boolean;
+    /**
+     * The account labels itself adult by its own handle, display name or bio:
+     * cover its avatar unless the member turned Show NSFW on. Absent from
+     * servers older than this field and from reads that do not label accounts.
+     */
+    is_nsfw?: boolean;
     role: string;
     joined_at: string;
 }
@@ -1017,6 +1042,12 @@ export interface Profile {
     location: string | null;
     website: string | null;
     is_ai: boolean;
+    /**
+     * The account labels itself adult by its own handle, display name or bio:
+     * cover its avatar unless the member turned Show NSFW on. Absent from
+     * servers older than this field and from reads that do not label accounts.
+     */
+    is_nsfw?: boolean;
     created_at: string;
 }
 /** A row of a followers/following list: the profile plus the caller's relationship with it. */
@@ -1086,6 +1117,14 @@ export interface ProfileSearchResult extends Profile {
     plus: boolean;
     pro: boolean;
     founder: boolean;
+    /**
+     * The account wears the display name of a verified or founder account it is not: it is listed after every account
+     * that is not such a copy. Label it as not the account at `name_matches_verified_handle`. Absent from an older API.
+     */
+    name_matches_verified?: boolean;
+    name_matches_verified_handle?: string | null;
+    /** Whether the caller mutes this account (a search never lists an account in a block with the caller). */
+    viewer?: ViewerModeration;
 }
 export interface SearchMentionsParams {
     /** What the member typed after `@` (a leading `@` is ignored). */

package/llm.md

@@ -534,6 +534,8 @@ const { data: ids, next } = await r.e2ee.conversations({ limit: 200 });
 r.realtime.onE2eeDevices(({ deviceId, reason }) => {}); // 'packages': it can be claimed now; 'revoked'
 ```
 
+Revoking a device other active devices were approved through, or the account's root (main) device, throws a 409 `ConflictError` with code `has_dependents` and `details: { dependents: string[], root: boolean }`; nothing changes (0.7.58). `revokeDevice(id, { cascade: true })` revokes it and every device chained through it, answering `revoked` (ids). Once the root is revoked the account cannot link a new device.
+
 ### r.realtime — WebSocket Chat Client
 
 Provides persistent real-time streaming and chat presence, useful for building frontends (e.g. React Native, Web).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recursiv/sdk",
-  "version": "0.7.57",
+  "version": "0.7.58",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",