@recursiv/sdk 0.7.33 → 0.7.34

package/README.md

@@ -589,3 +589,5 @@ per-IP/app budgets. They return no subscriptions, personal safety preferences, a
 connections or signing authority. Missing configuration or unavailable safety checks fail
 closed. Signed-in members continue using `getPublicConversation` to apply personal
 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.

package/dist/index.d.ts

@@ -194,7 +194,7 @@ export type { UploadMediaInput, UploadUrlInput, UploadUrlResult } from './resour
 export { WalletResource } from './resources/wallet.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, } from './resources/protocols.js';
-export type { SocialProfile, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendFeed, SocialPopularProfiles, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeSocialCallbackInput, NativeReplyPrepareInput, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, 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, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendFeed, SocialPopularProfiles, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeSocialCallbackInput, NativeReplyPrepareInput, NativePostPrepareInput, NativePostBatch, NativePostHistory, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, 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 { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';

package/dist/resources/protocols.d.ts

@@ -589,6 +589,31 @@ export interface NativeReplyBatch {
         } | null;
     }>;
 }
+/** Public text only; accounts are selected explicitly in the shared editor. */
+export interface NativePostPrepareInput {
+    clientMutationId: string;
+    text: string;
+    accountIds: string[];
+}
+export interface NativePostBatch {
+    id: string;
+    clientMutationId: string;
+    expiresAt: string;
+    deliveries: Array<Omit<NativeReplyBatch['deliveries'][number], 'kind' | 'parent' | 'recoverable' | 'replacedBy'> & {
+        audience: 'public';
+        maxCharacters: number;
+    }>;
+}
+export interface NativePostHistory {
+    items: Array<{
+        id: string;
+        createdAt: string;
+        text: string;
+        textTruncated: boolean;
+        deliveries: Array<Omit<NativePostBatch['deliveries'][number], 'text' | 'wireText' | 'maxCharacters'>>;
+    }>;
+    cursor: string | null;
+}
 export interface NativeSocialCallbackInput {
     protocol: NativeSocialProtocol;
     state: string;
@@ -979,6 +1004,42 @@ export declare class ProtocolsResource {
     }): Promise<SingleResponse<NativeRepostReview>>;
     /** Reconcile the saved action without sending another native write. */
     nativeRepostStatus(id: string): Promise<SingleResponse<NativeRepostReview>>;
+    /** Prepare exact public text for selected connected Bluesky/ActivityPub accounts. */
+    prepareNativePost(input: NativePostPrepareInput): Promise<SingleResponse<NativePostBatch>>;
+    /** Explicitly approve selected deliveries; never auto-retry an uncertain write. */
+    submitNativePost(id: string, input: {
+        approve: true;
+        deliveryIds: string[];
+    }): Promise<SingleResponse<NativePostBatch & {
+        errors: Record<string, {
+            code: string;
+            message: string;
+        }>;
+    }>>;
+    /** Read the signed-in owner's saved publication review and durable receipts. */
+    nativePostStatus(id: string): Promise<SingleResponse<NativePostBatch>>;
+    /** Page the current app user's standalone publication history. This never sends. */
+    nativePostHistory(params?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<SingleResponse<NativePostHistory>>;
+    /** Review the current own posts before approving removal. */
+    prepareNativePostRemoval(id: string, input: {
+        deliveryIds: string[];
+    }): Promise<SingleResponse<NativeReplyRemovalPreview>>;
+    /** Remove only the explicitly reviewed own publications. */
+    removeNativePost(id: string, input: {
+        approve: true;
+        removals: Array<{
+            deliveryId: string;
+            removalId: string;
+        }>;
+    }): Promise<SingleResponse<NativePostBatch & {
+        errors: Record<string, {
+            code: string;
+            message: string;
+        }>;
+    }>>;
     /** Prepare one exact shared reply preview. Keep the mutation ID across uncertain responses. */
     prepareNativeReply(input: NativeReplyPrepareInput): Promise<SingleResponse<NativeReplyBatch>>;
     /** Send only explicitly approved delivery IDs from this preview. Repeated submissions reconcile; they do not replay a write. */

package/dist/resources/protocols.js

@@ -176,6 +176,35 @@ export class ProtocolsResource {
         hostedIdentityPath(id);
         return this.client.get(`/protocols/social/reposts/${encodeURIComponent(id)}`);
     }
+    /** 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 });
+    }
+    /** Explicitly approve selected deliveries; never auto-retry an uncertain write. */
+    submitNativePost(id, input) {
+        hostedIdentityPath(id);
+        return this.client.post(`/protocols/social/posts/${encodeURIComponent(id)}/submit`, { approve: input.approve, deliveryIds: input.deliveryIds }, { retry: false });
+    }
+    /** Read the signed-in owner's saved publication review and durable receipts. */
+    nativePostStatus(id) {
+        hostedIdentityPath(id);
+        return this.client.get(`/protocols/social/posts/${encodeURIComponent(id)}`);
+    }
+    /** Page the current app user's standalone publication history. This never sends. */
+    nativePostHistory(params = {}) {
+        return this.client.get('/protocols/social/posts', { limit: params.limit, cursor: params.cursor });
+    }
+    /** Review the current own posts before approving removal. */
+    prepareNativePostRemoval(id, input) {
+        hostedIdentityPath(id);
+        return this.client.post(`/protocols/social/posts/${encodeURIComponent(id)}/removals/prepare`, { deliveryIds: input.deliveryIds }, { retry: false });
+    }
+    /** Remove only the explicitly reviewed own publications. */
+    removeNativePost(id, input) {
+        hostedIdentityPath(id);
+        return this.client.post(`/protocols/social/posts/${encodeURIComponent(id)}/removals/submit`, { approve: input.approve, removals: input.removals.map(item => ({ deliveryId: item.deliveryId, removalId: item.removalId })) }, { retry: false });
+    }
     /** Prepare one exact shared reply preview. Keep the mutation ID across uncertain responses. */
     prepareNativeReply(input) {
         return this.client.post('/protocols/social/replies/prepare', { clientMutationId: input.clientMutationId, text: input.text,

package/llm.md

@@ -820,3 +820,5 @@ its author's deletion requests on the recorded relay. Other history items use
 publication; history stores no signature, signing key or intent. Keep the acting
 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.

package/package.json

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