@recursiv/sdk 0.7.27 → 0.7.29

package/dist/index.d.ts

@@ -171,7 +171,7 @@ export { VideoResource } from './resources/video.js';
 export type { VideoUploadCreds, CreateVideoUploadResult, VideoStatusInfo, VideoPlaybackToken, } from './resources/video.js';
 export { AppSubscriptionsResource } from './resources/app-subscriptions.js';
 export type { AppSubscriptionCheckoutResult, AppSubscriptionPortalResult, AppSubscriptionStatusResult, } from './resources/app-subscriptions.js';
-export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, } from './resources/curator.js';
+export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, CuratorTodayEdition, CuratorTodayResponse, CuratorTodaySource, CuratorTodayStory, } from './resources/curator.js';
 export { ReportsResource } from './resources/reports.js';
 export type { ReportTargetType, ReportStatus, CreateReportInput, ReportRecord, ResolveReportInput, } from './resources/reports.js';
 export { ModerationResource } from './resources/moderation.js';
@@ -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/accounts.d.ts

@@ -6,11 +6,15 @@ export interface SiblingAccount {
     username: string;
     name: string;
     image: string | null;
-    created_at: string;
+    created_at: string | null;
+    /** Followers on this account. The main-account rule reads this field. */
+    follower_count: number;
     /** The stored primary email is a migration placeholder, not a real inbox. */
     is_placeholder_email: boolean;
     /** Server heuristic used to collapse test/demo identities in account pickers. */
     looks_like_test: boolean;
+    /** The account OTP sign-in lands on. Exactly one row carries it. */
+    is_primary: boolean;
     is_current: boolean;
 }
 export interface SiblingAccountsResponse {
@@ -19,6 +23,8 @@ export interface SiblingAccountsResponse {
         /** The verified real address shared by the returned accounts. */
         email: string;
         count: number;
+        /** Id of the main account, or null when the caller has no usable address. */
+        primary_id?: string | null;
     };
 }
 export interface SwitchAccountResult {
@@ -36,7 +42,7 @@ export interface SwitchAccountResult {
 export declare class AccountsResource {
     private client;
     constructor(client: HttpClient);
-    /** List every account controlled by the caller's verified real email. */
+    /** List every account controlled by the caller's verified real email, main account first. */
     listSiblings(): Promise<SiblingAccountsResponse>;
     /** Mint a replacement key for a sibling account in the caller's project. */
     switchAccount(targetUserId: string): Promise<SingleResponse<SwitchAccountResult>>;

package/dist/resources/accounts.js

@@ -11,7 +11,7 @@ export class AccountsResource {
     constructor(client) {
         this.client = client;
     }
-    /** List every account controlled by the caller's verified real email. */
+    /** List every account controlled by the caller's verified real email, main account first. */
     listSiblings() {
         return this.client.get('/accounts/siblings');
     }

package/dist/resources/curator.d.ts

@@ -105,9 +105,77 @@ export interface CuratorSeedDeckResponse {
     data: CuratorSeedDeckItem[];
     meta: CuratorSeedDeckMeta;
 }
+/** Which half of the press an outlet belongs to. */
+export type CuratorOutletLane = 'mainstream' | 'independent';
+/** One outlet item behind a world story. Headline and link only, never an article body. */
+export interface CuratorTodaySource {
+    outlet: string;
+    /** The outlet's lane. Absent on stories written before lanes existed. */
+    lane?: CuratorOutletLane;
+    title: string;
+    url: string;
+    published_at: string | null;
+}
+/** Distinct outlets per lane behind a world story. */
+export interface CuratorTodayLaneMix {
+    mainstream: number;
+    independent: number;
+}
+export interface CuratorTodayStory {
+    id: string;
+    /** 1 = lead. World stories hold 1..N, Minds stories follow. */
+    rank: number;
+    /**
+     * 'world': the open web set it, ranked by how many outlets moved on it in
+     * the last 24 h with an independent outlet weighted above a mainstream one.
+     * 'minds': a group of real Minds posts.
+     */
+    kind: 'world' | 'minds';
+    kicker: string;
+    headline: string;
+    dek: string | null;
+    topic: string | null;
+    /** Outlet links for a world story; null for a Minds story. */
+    sources: CuratorTodaySource[] | null;
+    /** Distinct outlets behind a world story; null for a Minds story. */
+    outlet_count: number | null;
+    /** Distinct outlets per lane behind a world story; null for a Minds story. */
+    lane_mix: CuratorTodayLaneMix | null;
+    /**
+     * Which lanes carry a world story: 'mainstream', 'independent' (nobody in
+     * the mainstream lane ran it) or 'both'. Null for a Minds story.
+     */
+    lane: CuratorOutletLane | 'both' | null;
+    /** The discussion-room post when one exists. */
+    discussion_post_id: string | null;
+    /** Replies on the discussion post; 0 when there is none. */
+    reply_count: number;
+    /** Minds posts in the same shape as `sdk.posts.list()`. May be empty for a world story. */
+    posts: Post[];
+}
+export interface CuratorTodayEdition {
+    id: string;
+    edition_date: string;
+    status: 'draft' | 'published';
+    generated_at: string;
+    stories: CuratorTodayStory[];
+}
+export interface CuratorTodayResponse {
+    /** null when the network has no published edition yet. */
+    data: CuratorTodayEdition | null;
+    meta: {
+        generating: boolean;
+    };
+}
 export declare class CuratorResource {
     private client;
     constructor(client: HttpClient);
+    /**
+     * Today: the daily front page for the caller's network. World stories
+     * (set by the open web, ranked by outlet count) come first; Minds
+     * conversation stories follow. Requires `posts:read`.
+     */
+    today(): Promise<CuratorTodayResponse>;
     /**
      * Fetch the supplied sources in parallel, annotate each top item with
      * the supplied prompt template, and insert audience-scoped posts into

package/dist/resources/curator.js

@@ -3,6 +3,14 @@ export class CuratorResource {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Today: the daily front page for the caller's network. World stories
+     * (set by the open web, ranked by outlet count) come first; Minds
+     * conversation stories follow. Requires `posts:read`.
+     */
+    today() {
+        return this.client.get('/curator/today');
+    }
     /**
      * Fetch the supplied sources in parallel, annotate each top item with
      * the supplied prompt template, and insert audience-scoped posts into

package/dist/resources/protocols.d.ts

@@ -82,7 +82,12 @@ export interface ProtocolQuarantinedCandidate {
     provider: string;
     /** Safe IDs are byte-exact; null means unsafe or malformed provenance was withheld. */
     external_id: string | null;
-    state: 'quarantined';
+    state: ProtocolCandidateState;
+    /** Increments whenever the payload digest changes; decisions and verdicts are keyed by it. */
+    revision: number;
+    revision_digest: string | null;
+    /** Latest screening verdict on the current revision, or null when unscreened. */
+    latest_verdict: ProtocolCandidateVerdictSummary | null;
     title: string | null;
     content: string;
     content_format: 'plain';
@@ -99,9 +104,88 @@ export interface ProtocolQuarantinedCandidate {
     observed_at: string;
     created_at: string;
 }
+export type ProtocolCandidateState = 'quarantined' | 'approved' | 'rejected' | 'escalated' | 'tombstoned';
+export type ProtocolScreeningVerdict = 'pass' | 'hold' | 'fail';
+export type ProtocolCandidateDecision = 'approved' | 'rejected' | 'escalated';
+export interface ProtocolCandidateVerdictSummary {
+    verdict: ProtocolScreeningVerdict;
+    line: string;
+    category: string | null;
+    high_risk: boolean;
+    reason: string | null;
+    created_at: string;
+}
+export interface ProtocolCandidateVerdict extends ProtocolCandidateVerdictSummary {
+    id: string;
+    revision: number;
+    model: string | null;
+    confidence: number | null;
+}
+export interface DecideProtocolCandidateInput {
+    decision: ProtocolCandidateDecision;
+    /** Required for escalation; recorded on every decision. */
+    reason?: string;
+}
+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;
+    /** Candidate state to list; the API defaults to quarantined. */
+    state?: ProtocolCandidateState;
     /** Page size, default 20 and maximum 50; enforced by the API. */
     limit?: number;
     /** Opaque cursor from this endpoint's previous page; never an offset. */
@@ -464,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;
 }
@@ -565,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. */
@@ -636,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. */
@@ -784,6 +892,41 @@ export declare class ProtocolsResource {
      * unsupported deployed route) propagate; they are never an empty page.
      */
     listCandidates(params?: ListProtocolCandidatesParams): Promise<ProtocolCandidateListResponse>;
+    /**
+     * Run fail-closed screening on a candidate's current revision. Requires the
+     * app's content_intelligence_admin binding (404 otherwise) and the same
+     * project-admin authorization as listCandidates. A failed or unconfigured
+     * classifier records hold, never pass.
+     */
+    screenCandidate(id: string): Promise<SingleResponse<ProtocolQuarantinedCandidate>>;
+    /** Screening verdict history for a candidate, newest first. */
+    listCandidateVerdicts(id: string): Promise<SingleResponse<ProtocolCandidateVerdict[]>>;
+    /**
+     * Record a decision on the candidate's current revision. Approval needs a
+     * signed-in human project admin and a pass verdict on the current digest;
+     * 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,
@@ -282,24 +286,63 @@ export class ProtocolsResource {
     listCandidates(params) {
         return this.client.get('/protocols/candidates', params ? {
             protocol: params.protocol,
+            state: params.state,
             limit: params.limit,
             cursor: params.cursor,
         } : undefined);
     }
+    /**
+     * Run fail-closed screening on a candidate's current revision. Requires the
+     * app's content_intelligence_admin binding (404 otherwise) and the same
+     * project-admin authorization as listCandidates. A failed or unconfigured
+     * classifier records hold, never pass.
+     */
+    async screenCandidate(id) {
+        return this.client.post(`/protocols/candidates/${encodeURIComponent(assertCandidateId(id))}/screen`, {});
+    }
+    /** Screening verdict history for a candidate, newest first. */
+    async listCandidateVerdicts(id) {
+        return this.client.get(`/protocols/candidates/${encodeURIComponent(assertCandidateId(id))}/verdicts`);
+    }
+    /**
+     * Record a decision on the candidate's current revision. Approval needs a
+     * signed-in human project admin and a pass verdict on the current digest;
+     * an agent key may only reject or escalate; escalation needs a reason.
+     */
+    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;
      * all other IDs are encoded as one path segment and validated by the API.
      */
     async getCandidate(id) {
-        if (typeof id !== 'string' || !id.trim() || id === '.' || id === '..') {
-            throw new ValidationError({
-                type: 'validation_error',
-                code: 'invalid_candidate_id',
-                message: 'Candidate ID must be a non-empty identifier, not a URL dot segment.',
-            });
-        }
-        return this.client.get(`/protocols/candidates/${encodeURIComponent(id)}`);
+        return this.client.get(`/protocols/candidates/${encodeURIComponent(assertCandidateId(id))}`);
     }
     /** Cross-protocol full-text search */
     search(params) {
@@ -318,3 +361,13 @@ export class ProtocolsResource {
         return this.client.put('/protocols/settings', input);
     }
 }
+function assertCandidateId(id) {
+    if (typeof id !== 'string' || !id.trim() || id === '.' || id === '..') {
+        throw new ValidationError({
+            type: 'validation_error',
+            code: 'invalid_candidate_id',
+            message: 'Candidate ID must be a non-empty identifier, not a URL dot segment.',
+        });
+    }
+    return id;
+}

package/package.json

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