@recursiv/sdk 0.7.25 → 0.7.26

package/README.md

@@ -454,3 +454,8 @@ approve: true })`. Preserve that exact event on uncertain retries. Check
 `getNativeNostrPost(identityId, eventId)` for relay visibility. An owned note can
 prepare `{ action: 'delete', postId }`; deletion is a signed request, not a
 promise of erasure across all relays. Keys are never sent to this SDK service.
+Preparation and submission never retry automatically, even when `maxRetries` is
+configured. After an uncertain submission, check
+`getNativeNostrPost(identityId, preview.postId ?? preview.eventId)`: deletion uses
+the original note's `postId`, while publication uses the new `eventId`. Any
+user-selected retry must keep the same intent and signed event.

package/dist/client.d.ts

@@ -30,7 +30,9 @@ export declare class HttpClient {
     private getAuthHeaders;
     private handleResponse;
     get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
-    post<T>(path: string, body?: unknown): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: {
+        retry?: boolean;
+    }): Promise<T>;
     put<T>(path: string, body?: unknown): Promise<T>;
     patch<T>(path: string, body?: unknown): Promise<T>;
     delete<T>(path: string): Promise<T>;

package/dist/client.js

@@ -165,16 +165,17 @@ export class HttpClient {
         });
         return this.handleResponse(response);
     }
-    async post(path, body) {
+    async post(path, body, options) {
         const url = this.buildUrl(path);
-        const response = await this.fetchWithRetry(url, {
+        const request = {
             method: 'POST',
             headers: {
                 ...this.getAuthHeaders(),
                 'Content-Type': 'application/json',
             },
             body: body ? JSON.stringify(body) : undefined,
-        });
+        };
+        const response = await (options?.retry === false ? this.fetchWithTimeout(url, request) : this.fetchWithRetry(url, request));
         return this.handleResponse(response);
     }
     async put(path, body) {

package/dist/resources/protocols.d.ts

@@ -421,8 +421,10 @@ export declare class ProtocolsResource {
     }): Promise<SingleResponse<SocialTrendFeed>>;
     /** Native writes are off unless enabled for this exact app; public readers are independent. */
     nativeNostrAccount(): Promise<SingleResponse<NativeNostrAccount>>;
+    /** Prepare an exact event for review. A timeout never automatically creates another signing request. */
     prepareNativeNostr(id: string, input: NativeNostrPrepareInput): Promise<SingleResponse<NativeNostrPrepared>>;
-    /** Pass only the public signed event. Retry with this same intent/event, never sign a replacement after a timeout. */
+    /** Pass only the public signed event. After a timeout, read the prepared postId (delete) or eventId (publish).
+     * Any user-selected retry keeps the same intent/event. */
     submitNativeNostr(id: string, input: {
         intent: string;
         event: HostedNostrIdentityProof;

package/dist/resources/protocols.js

@@ -94,18 +94,20 @@ export class ProtocolsResource {
     nativeNostrAccount() {
         return this.client.get('/protocols/social/nostr/account');
     }
+    /** Prepare an exact event for review. A timeout never automatically creates another signing request. */
     prepareNativeNostr(id, input) {
         hostedIdentityPath(id);
         const body = input.action === 'publish' ? { action: input.action, content: input.content } : { action: input.action, postId: input.postId };
-        return this.client.post(`/protocols/social/nostr/${encodeURIComponent(id)}/prepare`, body);
+        return this.client.post(`/protocols/social/nostr/${encodeURIComponent(id)}/prepare`, body, { retry: false });
     }
-    /** Pass only the public signed event. Retry with this same intent/event, never sign a replacement after a timeout. */
+    /** Pass only the public signed event. After a timeout, read the prepared postId (delete) or eventId (publish).
+     * Any user-selected retry keeps the same intent/event. */
     submitNativeNostr(id, input) {
         hostedIdentityPath(id);
         const { id: eventId, pubkey, sig, kind, content, created_at, tags } = input.event;
         return this.client.post(`/protocols/social/nostr/${encodeURIComponent(id)}/submit`, {
             intent: input.intent, event: { id: eventId, pubkey, sig, kind, content, created_at, tags }, approve: input.approve,
-        });
+        }, { retry: false });
     }
     getNativeNostrPost(id, postId) {
         hostedIdentityPath(id);

package/llm.md

@@ -620,6 +620,7 @@ if (subscription.active) {
 - `r.inviteCodes` / `r.inviteCodesAdmin` — Invite code management
 - `r.organizationSettings` / `r.organizationSecurity` — Org configuration
 - `r.protocols` — Public reading: `publicNetworks`, `searchPublicProfiles`, `getPublicProfile`, `getPublicAuthorFeed`, `getFollowingFeed`, `getPublicConversation`, `getPublicTrends`, `getPublicTrendFeed`; private app subscriptions: `listSubscriptions`, `subscribeToProfile`, `unsubscribeFromProfile`, `onSubscriptionChange`. Example after selecting a returned source post: `const { data: thread } = await r.protocols.getPublicConversation({ protocol: post.protocol, post: post.nativeId, readRef: post.readRef })`. Render `focus`, oldest-first `ancestors` and direct `replies`; `public_provider_window` never promises every reply, and `limited` marks known omissions. Requires both `users:read` and `posts:read` on the current human app key. Protocol discovery/settings: `const { data: adapters } = await r.protocols.list()` returns bounded `{ id, name, icon, color, maturity, capabilities, limitations }` metadata; `supported` means implemented, not configured, healthy, authorized, or enabled. Methods: `list`, `status`, `listCandidates`, `getCandidate`, `search`, `getSettings`, `refresh`, `updateSettings`.
+  - Native Nostr: `const { data: preview } = await r.protocols.prepareNativeNostr(identityId, { action: "publish", content: draft })`; review and sign the exact public event, then `submitNativeNostr(identityId, { intent: preview.intent, event, approve: true })`. Preparation/submission never auto-retry. After uncertainty, use `getNativeNostrPost(identityId, preview.postId ?? preview.eventId)` before a user-selected retry of the identical intent/event: deletion checks the original note's `postId`, publication checks `eventId`. Check `nativeNostrAccount()` enablement first; keys stay with the signer.
   - Public trends: require `public_trends` from `publicNetworks()`, then `getPublicTrends({ protocol, limit?, cursor? })`; render `kind: topics` as source topics and `kind: posts` as source posts. With `trend_feed`, open only a returned current topic using `getPublicTrendFeed({ protocol, topic: trend.nativeId, limit?, cursor? })`. Show provider, observedAt and provider_ranked_window coverage; null rankingWindow is unknown, not a daily/global ranking. Preserve source order, canonical IDs and readRef, and opaque cursors. Topic catalogs do not paginate; Mastodon trends stop at 200 source positions. Both methods require users:read plus posts:read on the current human app key; Nostr trends are unsupported. Propagate errors; trend_unavailable means refresh the topic list. No ingestion or native writes.
   - `listCandidates({ protocol?, limit?, cursor? })` and `getCandidate(id)` are read-only quarantine review, not published-post search. Both require `admin` scope, a project-bound key, a live admin role, and existing project-admin access. The key supplies app/network scope; neither method accepts another project or network. They never invoke refresh, change settings, or publish.
   - Lists return `{ data: ProtocolQuarantinedCandidate[], meta: { limit, has_more, next_cursor } }`; use the opaque `next_cursor`, not offset pagination. The API defaults `limit` to 20 and permits at most 50. Details return `{ data: ProtocolQuarantinedCandidate }`. Every candidate has `state: 'quarantined'` and `content_format: 'plain'`; render its bounded `content` as text, respect `content_truncated`, and distinguish upstream `published_at` from local `observed_at` / `created_at`.

package/package.json

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