@recursiv/sdk 0.7.28 → 0.7.29

package/dist/index.d.ts

@@ -189,7 +189,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, SocialAuthorFeed, SocialFollowingFeed, SocialFollowingSource, SearchPublicProfilesParams, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeSocialCallbackInput, NativeReplyPrepareInput, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, PreviewHostedPostInput, PublishHostedPostInput, ListProtocolCandidatesParams, ProtocolAdapterMaturity, ProtocolAdapterMetadata, ProtocolCandidateListResponse, ProtocolCandidatePageMeta, ProtocolCapabilityOperation, ProtocolCapabilityStatus, ProtocolCollectionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, 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, 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

@@ -130,6 +130,57 @@ export interface ProtocolCandidateDecisionResult {
     candidate: ProtocolQuarantinedCandidate;
     decision_id: string;
 }
+/** Operator view of the durable ingestion runtime for the authenticated app (goal ed3759f0 row 7). */
+export interface ProtocolIngestionStatus {
+    /** Exactly one ingestion writer per process: the legacy collector or the runtime. */
+    mode: 'collector' | 'runtime';
+    enabled: boolean;
+    simulation: boolean;
+    /** Process-wide PROTOCOL_INGESTION_KILL_SWITCH. */
+    global_kill_switch: boolean;
+    controls_valid: boolean;
+    /** Whether this app's tuple is on the PROTOCOL_INGESTION_PROJECTS allow-list. */
+    project_allowed: boolean;
+    /** This app's operator kill switch (protocol_collection_setting.kill_switch). */
+    kill_switch: boolean;
+    jobs: {
+        queued: number;
+        leased: number;
+        done: number;
+        dead: number;
+    };
+    quotas: Array<{
+        provider_id: string;
+        window: 'run' | 'hour' | 'day';
+        killed: boolean;
+        circuit_open_until: string | null;
+        circuit_failures: number;
+        consumed: {
+            calls: number;
+            items: number;
+            bytes: number;
+        };
+        ceilings: {
+            calls: number | null;
+            items: number | null;
+            bytes: number | null;
+        };
+    }>;
+    lanes: Array<{
+        provider_id: string;
+        source_key: string;
+        source_subscription_key: string;
+        active: boolean;
+    }>;
+}
+export interface ReplayProtocolIngestionJobInput {
+    /** Operator note recorded on the audit row; 8 to 1024 characters. */
+    reason: string;
+}
+export interface ProtocolIngestionReplayResult {
+    job_id: string;
+    status: 'replayed';
+}
 /** App/network scope comes only from the authenticated project-bound key. */
 export interface ListProtocolCandidatesParams {
     protocol?: string;
@@ -497,7 +548,7 @@ 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'>;
+    capabilities: Array<'profile_search' | 'profile_read' | 'original_author_posts' | 'minds_subscription' | 'following_feed' | 'conversation_read' | 'public_trends' | 'trend_feed' | 'popular_accounts'>;
     profileSearchPagination: boolean;
     conversationCoverage?: string;
 }
@@ -598,6 +649,24 @@ export interface SocialTrendFeed extends SocialTrendProvenance {
     items: SocialPost[];
     cursor: string | null;
 }
+/** Provider-ranked accounts. `source` says whether this page is the app's hourly index snapshot or a live read. */
+export interface SocialPopularProfiles {
+    items: SocialProfile[];
+    cursor: string | null;
+    provenance: {
+        provider: {
+            name: string;
+            url: string;
+        };
+        /** The provider's own ranking label, never a Minds popularity score. */
+        ranking: string;
+        fetchedAt: string;
+        coverage: 'provider_ranked_window';
+        source: 'index' | 'live';
+        /** Provider read time of the served snapshot; null for live reads. */
+        snapshotAt: string | null;
+    };
+}
 export interface SocialConversation {
     focus: SocialPost;
     /** Oldest available ancestor first, ending with the immediate parent. */
@@ -669,6 +738,12 @@ export declare class ProtocolsResource {
         limit?: number;
         cursor?: string;
     }): Promise<SingleResponse<SocialTrendFeed>>;
+    /** Provider-ranked public accounts with explicit provenance; served from the app's index when a fresh snapshot exists. */
+    getPublicPopularProfiles(params: {
+        protocol: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<SingleResponse<SocialPopularProfiles>>;
     /** 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. */
@@ -832,6 +907,26 @@ export declare class ProtocolsResource {
      * an agent key may only reject or escalate; escalation needs a reason.
      */
     decideCandidate(id: string, input: DecideProtocolCandidateInput): Promise<SingleResponse<ProtocolCandidateDecisionResult>>;
+    /**
+     * Read the ingestion runtime status for the key's app: mode, switches, job
+     * counts, quota ledger and lanes. Read-only. Requires the app's
+     * content_intelligence_admin binding (404 otherwise) and the same
+     * project-admin authorization as listCandidates.
+     */
+    ingestionStatus(): Promise<SingleResponse<ProtocolIngestionStatus>>;
+    /** Turn the app's ingestion kill switch on: no reservation, screening or approval proceeds. */
+    killIngestion(): Promise<SingleResponse<{
+        kill_switch: true;
+    }>>;
+    /** Turn the app's ingestion kill switch off. Does not enable the runtime by itself. */
+    resumeIngestion(): Promise<SingleResponse<{
+        kill_switch: false;
+    }>>;
+    /**
+     * Requeue one dead ingestion job. Refused (409) while the runtime is
+     * disabled, simulating or killed; 404 when no dead job matches in this app.
+     */
+    replayIngestionJob(jobId: string, input: ReplayProtocolIngestionJobInput): Promise<SingleResponse<ProtocolIngestionReplayResult>>;
     /**
      * Read one quarantined candidate under the same authorization as listCandidates.
      * Empty and URL dot-segment IDs reject with ValidationError before any request;

package/dist/resources/protocols.js

@@ -96,6 +96,10 @@ export class ProtocolsResource {
     getPublicTrendFeed(params) {
         return this.client.get('/protocols/social/trend-feed', { protocol: params.protocol, topic: params.topic, limit: params.limit, cursor: params.cursor });
     }
+    /** Provider-ranked public accounts with explicit provenance; served from the app's index when a fresh snapshot exists. */
+    getPublicPopularProfiles(params) {
+        return this.client.get('/protocols/social/popular-profiles', { protocol: params.protocol, limit: params.limit, cursor: params.cursor });
+    }
     /** 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,
@@ -308,6 +312,30 @@ export class ProtocolsResource {
     async decideCandidate(id, input) {
         return this.client.post(`/protocols/candidates/${encodeURIComponent(assertCandidateId(id))}/decision`, input);
     }
+    /**
+     * Read the ingestion runtime status for the key's app: mode, switches, job
+     * counts, quota ledger and lanes. Read-only. Requires the app's
+     * content_intelligence_admin binding (404 otherwise) and the same
+     * project-admin authorization as listCandidates.
+     */
+    ingestionStatus() {
+        return this.client.get('/protocols/ingestion/status');
+    }
+    /** Turn the app's ingestion kill switch on: no reservation, screening or approval proceeds. */
+    killIngestion() {
+        return this.client.post('/protocols/ingestion/kill', {});
+    }
+    /** Turn the app's ingestion kill switch off. Does not enable the runtime by itself. */
+    resumeIngestion() {
+        return this.client.post('/protocols/ingestion/resume', {});
+    }
+    /**
+     * Requeue one dead ingestion job. Refused (409) while the runtime is
+     * disabled, simulating or killed; 404 when no dead job matches in this app.
+     */
+    async replayIngestionJob(jobId, input) {
+        return this.client.post(`/protocols/ingestion/replay/${encodeURIComponent(assertCandidateId(jobId))}`, input);
+    }
     /**
      * Read one quarantined candidate under the same authorization as listCandidates.
      * Empty and URL dot-segment IDs reject with ValidationError before any request;

package/package.json

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