@recursiv/sdk 0.7.27 → 0.7.28

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';

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,37 @@ 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;
+}
 /** 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. */
@@ -784,6 +817,21 @@ 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 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

@@ -282,24 +282,39 @@ 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 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 +333,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.28",
   "description": "TypeScript SDK for the Recursiv API",
   "license": "FSL-1.1-ALv2",
   "type": "module",