@recursiv/sdk 0.7.33 → 0.7.35

package/README.md

@@ -111,7 +111,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), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `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: `publicNetworks`, `searchPublicProfiles`, `getPublicProfile`, `getPublicAuthorFeed`, `getFollowingFeed`, `getPublicConversation`, `getPublicTrends`, `getPublicTrendFeed`; 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), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `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`; 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/`.
 
@@ -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, SearchPublicPostsParams, SocialPostSearch, 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;
@@ -742,8 +767,9 @@ export interface SocialNetwork {
         url: string;
     };
     coverage: string;
-    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription' | 'following_feed' | 'conversation_read' | 'public_trends' | 'trend_feed' | 'popular_accounts'>;
+    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription' | 'following_feed' | 'conversation_read' | 'public_trends' | 'trend_feed' | 'popular_accounts' | 'post_search'>;
     profileSearchPagination: boolean;
+    postSearchAccountRequired?: boolean;
     conversationCoverage?: string;
 }
 /** Public source identity, independent of any local Minds user or handle. */
@@ -805,6 +831,25 @@ export interface SocialPost {
     }>;
     hasAdditionalContent: boolean;
 }
+export interface SocialPostSearch {
+    items: SocialPost[];
+    cursor: string | null;
+    query: string;
+    provider: {
+        name: string;
+        url: string;
+    };
+    observedAt: string;
+    coverage: 'provider_search_window';
+    readerAccountId: string | null;
+}
+export interface SearchPublicPostsParams {
+    protocol: 'bluesky' | 'activitypub' | 'nostr';
+    query: string;
+    accountId?: string;
+    limit?: number;
+    cursor?: string;
+}
 export interface SocialAuthorFeed {
     items: SocialPost[];
     cursor: string | null;
@@ -907,6 +952,15 @@ export declare class ProtocolsResource {
     }): Promise<SingleResponse<SocialConversation>>;
     publicNetworks(): Promise<SingleResponse<SocialNetwork[]>>;
     /** Query the live public network. It does not import users or posts. */
+    searchPublicPosts(params: SearchPublicPostsParams): Promise<SingleResponse<SocialPostSearch>>;
+    /** Read public-only conversation content through the current owner's selected account. */
+    getConnectedSocialConversation(params: {
+        protocol: 'bluesky' | 'activitypub';
+        accountId: string;
+        post: string;
+        readRef?: string;
+    }): Promise<SingleResponse<SocialConversation>>;
+    /** Search public profiles from a network's configured provider. */
     searchPublicProfiles(params: SearchPublicProfilesParams): Promise<SingleResponse<SocialProfilePage>>;
     getPublicProfile(protocol: string, actor: string): Promise<SingleResponse<SocialProfile>>;
     getPublicAuthorFeed(params: {
@@ -979,6 +1033,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. */
@@ -1040,6 +1130,7 @@ export declare class ProtocolsResource {
     reportSource(input: {
         source: SocialSourceRef;
         readRef?: string;
+        accountId?: string;
         reason: string;
         details?: string;
         scope: 'minds';

package/dist/resources/protocols.js

@@ -74,6 +74,15 @@ export class ProtocolsResource {
         return this.client.get('/protocols/social/networks');
     }
     /** Query the live public network. It does not import users or posts. */
+    searchPublicPosts(params) {
+        return this.client.get('/protocols/social/post-search', { protocol: params.protocol, query: params.query,
+            accountId: params.accountId, limit: params.limit, cursor: params.cursor });
+    }
+    /** Read public-only conversation content through the current owner's selected account. */
+    getConnectedSocialConversation(params) {
+        return this.client.get('/protocols/social/connected-conversation', { protocol: params.protocol, accountId: params.accountId, post: params.post, readRef: params.readRef });
+    }
+    /** Search public profiles from a network's configured provider. */
     searchPublicProfiles(params) {
         return this.client.get('/protocols/social/profiles', {
             protocol: params.protocol, query: params.query, limit: params.limit, cursor: params.cursor,
@@ -176,6 +185,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,
@@ -239,7 +277,7 @@ export class ProtocolsResource {
     /** File a report in the app's existing moderation queue, using server-read public source evidence. */
     reportSource(input) {
         return this.client.post('/protocols/social/reports', { source: { protocol: input.source.protocol, kind: input.source.kind, nativeId: input.source.nativeId },
-            readRef: input.readRef, reason: input.reason, details: input.details, scope: input.scope }, { retry: false });
+            readRef: input.readRef, ...(input.accountId ? { accountId: input.accountId } : {}), reason: input.reason, details: input.details, scope: input.scope }, { retry: false });
     }
     /** Open the returned authorization URL in the user's browser; never submit passwords or tokens. */
     startNativeSocialConnection(input) {

package/llm.md

@@ -820,3 +820,7 @@ 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.
+
+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.33",
+  "version": "0.7.35",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",