@recursiv/sdk 0.7.48 → 0.7.50

package/dist/index.d.ts

@@ -144,7 +144,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, E2eeEnvelope, E2eeEvent, E2eeKeyPackageStatus } from './resources/e2ee.js';
+export type { E2eeDevice, E2eeEnvelope, E2eeEvent, E2eeKeyPackageStatus, E2eeObjectDownload, E2eeObjectUpload } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
 export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';
@@ -180,7 +180,7 @@ export { VideoResource } from './resources/video.js';
 export type { VideoUploadCreds, CreateVideoUploadResult, VideoStatusInfo, VideoPlaybackToken, } from './resources/video.js';
 export { AppSubscriptionsResource } from './resources/app-subscriptions.js';
 export type { AppSubscriptionCheckoutResult, AppSubscriptionPortalResult, AppSubscriptionStatusResult, } from './resources/app-subscriptions.js';
-export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, CuratorTodayEdition, CuratorTodayResponse, CuratorTodaySource, CuratorTodayStory, } from './resources/curator.js';
+export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, CuratorTodayEdition, CuratorTodayExcerpt, CuratorTodayLeadImage, CuratorTodayRadar, CuratorTodayReaction, CuratorTodayResponse, CuratorTodaySource, CuratorTodayStory, } from './resources/curator.js';
 export { ReportsResource } from './resources/reports.js';
 export type { ReportTargetType, ReportStatus, CreateReportInput, ReportRecord, ResolveReportInput, } from './resources/reports.js';
 export { ModerationResource } from './resources/moderation.js';

package/dist/resources/communities.d.ts

@@ -8,6 +8,10 @@ export declare class CommunitiesResource {
     /** Get a community by ID */
     get(id: string): Promise<SingleResponse<CommunityDetail>>;
     /** List members of a community */
+    /** Groups related to this one, ranked by shared members; the caller's own groups are left out. */
+    related(id: string, params?: {
+        limit?: number;
+    }): Promise<PaginatedResponse<Community>>;
     members(id: string, params?: PaginationParams): Promise<PaginatedResponse<CommunityMember>>;
     /** Create a new community */
     create(input: CreateCommunityInput): Promise<SingleResponse<CreatedCommunity>>;

package/dist/resources/communities.js

@@ -12,6 +12,10 @@ export class CommunitiesResource {
         return this.client.get(`/communities/${id}`);
     }
     /** List members of a community */
+    /** Groups related to this one, ranked by shared members; the caller's own groups are left out. */
+    related(id, params) {
+        return this.client.get(`/communities/${encodeURIComponent(id)}/related`, params);
+    }
     members(id, params) {
         return this.client.get(`/communities/${id}/members`, params);
     }

package/dist/resources/curator.d.ts

@@ -116,6 +116,40 @@ export interface CuratorTodaySource {
     url: string;
     published_at: string | null;
 }
+/** One outlet's own words about a world story, quoted with the outlet. */
+export interface CuratorTodayExcerpt {
+    outlet: string;
+    lane: CuratorOutletLane;
+    title: string;
+    url: string;
+    text: string;
+}
+/** An image a Minds member posted about the story. */
+export interface CuratorTodayLeadImage {
+    url: string;
+    post_id: string;
+    author_name: string | null;
+    author_username: string | null;
+}
+/** A post the topic radar counted under the story. Remote posts carry no link to their own network. */
+export interface CuratorTodayReaction {
+    cluster_id: string;
+    network: 'bluesky' | 'activitypub' | 'nostr' | 'minds';
+    text: string;
+    published_at: string;
+    likes: number;
+    reposts: number;
+    replies: number;
+    /** Minds reactions only: the post to open. */
+    post_id?: string;
+}
+/** The topic radar cluster a world story seeded. */
+export interface CuratorTodayRadar {
+    cluster_id: string;
+    kind: 'breaking' | 'viral' | 'story';
+    sources: Partial<Record<'outlet' | 'hackernews' | 'bluesky' | 'activitypub' | 'nostr' | 'minds', number>>;
+    reactions: CuratorTodayReaction[];
+}
 /** Distinct outlets per lane behind a world story. */
 export interface CuratorTodayLaneMix {
     mainstream: number;
@@ -152,6 +186,14 @@ export interface CuratorTodayStory {
     reply_count: number;
     /** Minds posts in the same shape as `sdk.posts.list()`. May be empty for a world story. */
     posts: Post[];
+    /** World stories only: up to three outlet teasers, one per outlet. */
+    excerpts?: CuratorTodayExcerpt[];
+    /** World stories only: 'outlet' when the dek is an outlet's sentence, 'editor' when the world editor model wrote it. */
+    dek_origin?: 'outlet' | 'editor' | null;
+    /** World stories only: the first image among the story's Minds posts. */
+    lead_image?: CuratorTodayLeadImage | null;
+    /** World stories only: the radar cluster the story seeded, or null. */
+    radar?: CuratorTodayRadar | null;
 }
 export interface CuratorTodayEdition {
     id: string;

package/dist/resources/e2ee.d.ts

@@ -43,6 +43,19 @@ export interface E2eeKeyPackageStatus {
  * Requires the `e2eeV2` network feature flag and a key acting as the account
  * owner (agent-scoped keys are refused). The realm is the network id.
  */
+/** A reserved encrypted attachment object: PUT exactly `length` bytes of ciphertext to `uploadUrl`, then complete it. */
+export interface E2eeObjectUpload {
+    reference: string;
+    uploadUrl: string;
+    uploadExpiresAt: string;
+    length: number;
+}
+/** A short-lived URL for a confirmed encrypted attachment object. */
+export interface E2eeObjectDownload {
+    reference: string;
+    downloadUrl: string;
+    length: number;
+}
 export declare class E2eeResource {
     private client;
     constructor(client: HttpClient);
@@ -109,4 +122,31 @@ export declare class E2eeResource {
     }): Promise<SingleResponse<{
         ackedSeq: number;
     }>>;
+    /**
+     * Reserve an encrypted attachment object in an encrypted conversation.
+     * `length` is the ciphertext size (recursiv-attachment-v1); the key never
+     * leaves the client, it travels inside the MLS message.
+     */
+    createObject(conversationId: string, input: {
+        device_id: string;
+        length: number;
+    }): Promise<SingleResponse<E2eeObjectUpload>>;
+    /** Confirm an upload; it counts only if the stored size equals the reserved length. */
+    completeObject(objectId: string, input: {
+        device_id: string;
+    }): Promise<SingleResponse<{
+        reference: string;
+        length: number;
+    }>>;
+    /** A short-lived download URL for a confirmed object in a conversation you can read. */
+    objectDownload(objectId: string, params: {
+        device_id: string;
+    }): Promise<SingleResponse<E2eeObjectDownload>>;
+    /** Remove an object you uploaded. Copies recipients already downloaded stay theirs. */
+    deleteObject(objectId: string, params: {
+        device_id: string;
+    }): Promise<SingleResponse<{
+        reference: string;
+        deleted: boolean;
+    }>>;
 }

package/dist/resources/e2ee.js

@@ -1,9 +1,3 @@
-/**
- * E2EE v2 ciphertext transport. The server relays envelopes and public
- * credentials only; encryption happens in the shared core on each device.
- * Requires the `e2eeV2` network feature flag and a key acting as the account
- * owner (agent-scoped keys are refused). The realm is the network id.
- */
 export class E2eeResource {
     client;
     constructor(client) {
@@ -44,4 +38,24 @@ export class E2eeResource {
     acknowledge(conversationId, input) {
         return this.client.post(`/e2ee/conversations/${encodeURIComponent(conversationId)}/ack`, input);
     }
+    /**
+     * Reserve an encrypted attachment object in an encrypted conversation.
+     * `length` is the ciphertext size (recursiv-attachment-v1); the key never
+     * leaves the client, it travels inside the MLS message.
+     */
+    createObject(conversationId, input) {
+        return this.client.post(`/e2ee/conversations/${encodeURIComponent(conversationId)}/objects`, input);
+    }
+    /** Confirm an upload; it counts only if the stored size equals the reserved length. */
+    completeObject(objectId, input) {
+        return this.client.post(`/e2ee/objects/${encodeURIComponent(objectId)}/complete`, input);
+    }
+    /** A short-lived download URL for a confirmed object in a conversation you can read. */
+    objectDownload(objectId, params) {
+        return this.client.get(`/e2ee/objects/${encodeURIComponent(objectId)}`, params);
+    }
+    /** Remove an object you uploaded. Copies recipients already downloaded stay theirs. */
+    deleteObject(objectId, params) {
+        return this.client.delete(`/e2ee/objects/${encodeURIComponent(objectId)}?device_id=${encodeURIComponent(params.device_id)}`);
+    }
 }

package/dist/resources/posts.d.ts

@@ -12,6 +12,11 @@ export declare class PostsResource {
     }>>>;
     /** List posts the authenticated caller has upvoted. */
     liked(params?: Pick<ListPostsParams, 'limit' | 'offset' | 'cursor'>): Promise<PaginatedResponse<Post>>;
+    /** Posts similar to this one (embedding neighbours), in the app's scope. */
+    similar(id: string, params?: {
+        limit?: number;
+        organization_id?: string;
+    }): Promise<PaginatedResponse<Post>>;
     /** Get a single post with replies */
     get(id: string): Promise<SingleResponse<PostDetail>>;
     /** Create a new post */

package/dist/resources/posts.js

@@ -15,6 +15,10 @@ export class PostsResource {
     liked(params) {
         return this.list({ ...params, liked: true });
     }
+    /** Posts similar to this one (embedding neighbours), in the app's scope. */
+    similar(id, params) {
+        return this.client.get(`/posts/${encodeURIComponent(id)}/similar`, params);
+    }
     /** Get a single post with replies */
     get(id) {
         return this.client.get(`/posts/${id}`);

package/dist/resources/protocols.d.ts

@@ -1123,6 +1123,18 @@ export declare class ProtocolsResource {
         post: string;
         readRef?: string;
     }): Promise<SingleResponse<SocialConversation>>;
+    /** Public, app-moderated actor identity without member subscription/account state. */
+    getSharedProfile(projectId: string, params: {
+        protocol: string;
+        actor: string;
+    }): Promise<SingleResponse<Omit<SocialProfile, 'subscription'>>>;
+    /** Bounded original public posts by one actor, with current app moderation. */
+    getSharedAuthorFeed(projectId: string, params: {
+        protocol: string;
+        actor: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<SingleResponse<SocialAuthorFeed>>;
     /** Public, app-moderated discovery without account authority. Enrichment uses cached judgments only. */
     getSharedTrends(projectId: string, params: {
         protocol: string;

package/dist/resources/protocols.js

@@ -80,6 +80,15 @@ export class ProtocolsResource {
             protocol: params.protocol, post: params.post, readRef: params.readRef,
         });
     }
+    /** Public, app-moderated actor identity without member subscription/account state. */
+    getSharedProfile(projectId, params) {
+        return this.client.get(`/protocols/public/${encodeURIComponent(projectId)}/profile`, { protocol: params.protocol, actor: params.actor });
+    }
+    /** Bounded original public posts by one actor, with current app moderation. */
+    getSharedAuthorFeed(projectId, params) {
+        return this.client.get(`/protocols/public/${encodeURIComponent(projectId)}/author-feed`, { protocol: params.protocol, actor: params.actor,
+            limit: params.limit, cursor: params.cursor });
+    }
     /** Public, app-moderated discovery without account authority. Enrichment uses cached judgments only. */
     getSharedTrends(projectId, params) {
         return this.client.get(`/protocols/public/${encodeURIComponent(projectId)}/trends`, { protocol: params.protocol, limit: params.limit, cursor: params.cursor,

package/package.json

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