@recursiv/sdk 0.7.35 → 0.7.36

package/README.md

@@ -591,3 +591,5 @@ closed. Signed-in members continue using `getPublicConversation` to apply person
 blocks/mutes as well. All reply and account endpoints still require authentication.
 
 Standalone public text publication uses `protocols.prepareNativePost({ clientMutationId, text, accountIds })`, then explicitly approved `submitNativePost`. Keep the same mutation ID after uncertain preparation; previously attempted deliveries are reconciled without resending. `nativePostStatus` and paginated `nativePostHistory` expose private app/user-owned outcomes. Review current own posts with `prepareNativePostRemoval`, then approve exact removal IDs through `removeNativePost`. Check connected-account `publish_text` capabilities; only explicitly enabled apps may publish. Text is sent unchanged, public only, with each provider’s actual limits. These methods do not accept media, a reply parent or caller-supplied authority.
+
+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.

package/dist/resources/protocols.d.ts

@@ -594,6 +594,11 @@ export interface NativePostPrepareInput {
     clientMutationId: string;
     text: string;
     accountIds: string[];
+    /** Native quote on Bluesky only. The server reads the source and permissions using each selected account. */
+    quote?: {
+        protocol: 'bluesky';
+        nativeId: string;
+    };
 }
 export interface NativePostBatch {
     id: string;
@@ -602,6 +607,15 @@ export interface NativePostBatch {
     deliveries: Array<Omit<NativeReplyBatch['deliveries'][number], 'kind' | 'parent' | 'recoverable' | 'replacedBy'> & {
         audience: 'public';
         maxCharacters: number;
+        quote?: {
+            protocol: 'bluesky';
+            nativeId: string;
+            cid: string;
+            authorId: string;
+            authorHandle: string;
+            sourceUrl: string;
+            text: string;
+        };
     }>;
 }
 export interface NativePostHistory {
@@ -830,6 +844,13 @@ export interface SocialPost {
         alt: string;
     }>;
     hasAdditionalContent: boolean;
+    /** At most one independently filtered quoted post. */
+    quote?: {
+        state: 'available';
+        post: Omit<SocialPost, 'quote'>;
+    } | {
+        state: 'unavailable';
+    };
 }
 export interface SocialPostSearch {
     items: SocialPost[];

package/dist/resources/protocols.js

@@ -188,7 +188,8 @@ export class ProtocolsResource {
     /** Prepare exact public text for selected connected Bluesky/ActivityPub accounts. */
     prepareNativePost(input) {
         return this.client.post('/protocols/social/posts/prepare', { clientMutationId: input.clientMutationId,
-            text: input.text, accountIds: input.accountIds }, { retry: false });
+            text: input.text, accountIds: input.accountIds,
+            ...(input.quote ? { quote: { protocol: input.quote.protocol, nativeId: input.quote.nativeId } } : {}) }, { retry: false });
     }
     /** Explicitly approve selected deliveries; never auto-retry an uncertain write. */
     submitNativePost(id, input) {

package/llm.md

@@ -822,5 +822,6 @@ user/app-bound result IDs and discard UI state after an account switch. The last
 read-back observation is separate from retained publication/deletion evidence.
 
 Standalone public text posts: `prepareNativePost({ clientMutationId, text, accountIds })` → review → `submitNativePost(id, { approve: true, deliveryIds })`. Use `nativePostStatus(id)` / `nativePostHistory({limit,cursor})` for private durable outcomes and `prepareNativePostRemoval(id,{deliveryIds})` → `removeNativePost(id,{approve:true,removals:[{deliveryId,removalId}]})` for reviewed own-post removal. Check `publish_text` capability; no media, reply parent or audience override. Preserve mutation IDs, never create a new send to recover uncertainty.
+Bluesky quote: accounts must advertise `quote`; call `prepareNativePost({clientMutationId,text,accountIds,quote:{protocol:'bluesky',nativeId:sourceAtUri}})`, review each returned quote/account/comment, then approve via the same submit method. The server binds the source CID and rechecks permissions before sending. No cross-network quote conversion. Public reads expose one filtered `post.quote` (`available` with `post`, or `unavailable` without source details).
 
 Public post search (API/SDK 0.7.35): `const { data: page } = await r.protocols.searchPublicPosts({ protocol: 'nostr', query: 'open social', limit: 10 })`. Bluesky/ActivityPub require a selected `accountId` from `nativeSocialAccounts()` with `post_search`; older Bluesky grants must reconnect with consent. Open their results with `getConnectedSocialConversation({ protocol, accountId: page.readerAccountId, post: item.nativeId, readRef: item.readRef })` and pass the same accountId to `reportSource` for post reports. Nostr uses `getPublicConversation`. Pages report provider/observedAt and bounded coverage; no invented exhaustive or global search. Keep cursors paired with the exact owner, query, account, limit and connection revision. No writes, credentials or new ingestion are part of search.

package/package.json

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