@recursiv/sdk 0.7.58 → 0.7.59

package/README.md

@@ -75,7 +75,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | Resource | Key methods |
 |----------|------------|
 | `r.agents` | `create`, `update`, `chat`, `chatStream`, `retryChatStream`, `grantProjectAccess`, `conversations` |
-| `r.e2ee` | `status`, `registerDevice`, `devices`, `revokeDevice` (`{ cascade }` to also revoke devices approved through it; 409 `has_dependents` otherwise), `publishKeyPackages`, `keyPackageStatus`, `claimKeyPackage`, `appendEvent`, `events`, `acknowledge`, `conversations`; device linking by scan: `createLink`, `link`, `scannedLink`, `approveLink`, `completeLink`, `linkProgress`, `cancelLink` (flag-gated E2EE v2 transport; its doorbell is `r.realtime.onE2eeEvent`, which carries a small message's stored ciphertext to the owner's own sockets; link and device changes arrive on `r.realtime.onE2eeLink` and `onE2eeDevices`) |
+| `r.e2ee` | `status`, `registerDevice`, `devices`, `revokeDevice` (`{ cascade }` to also revoke devices approved through it; 409 `has_dependents` otherwise), `requestResetCode` and `resetAccount` (reset encrypted chat with an emailed code where `status().accountReset`), `publishKeyPackages`, `keyPackageStatus`, `claimKeyPackage`, `appendEvent`, `events`, `acknowledge`, `conversations`; device linking by scan: `createLink`, `link`, `scannedLink`, `approveLink`, `completeLink`, `linkProgress`, `cancelLink` (flag-gated E2EE v2 transport; its doorbell is `r.realtime.onE2eeEvent`, which carries a small message's stored ciphertext to the owner's own sockets; link and device changes arrive on `r.realtime.onE2eeLink` and `onE2eeDevices`) |
 | `r.brain` | `sendMessage` |
 | `r.commands` | `execute`, `gatePrompt` |
 | `r.projectBrain` | `tasks`, `decisions`, `milestones`, `completeTask`, `usage` |
@@ -115,7 +115,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; filter with `control`, each item may carry a `display` label), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `nativeFollowStates` (every connected account's state for one source, one read), `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`; radar stories: `getPublicRadarStory` (one story by id with its posts; one that left the radar within its minimum lifetime, or within the last half hour, still answers live with `liveUntil` and the story that continues it; one that has left for longer comes with its archived copy and the live story it continues as; the id may be a World Today edition story's, and the answer then names it in `editionStory` under the story's radar id), keyless `getSharedRadarStory(projectId, { cluster })` and `getSharedRadarPosts(projectId, { cluster })` (keyless reads carry images and videos only from outlets and members marked `visitorMedia`; signed-in reads keep all media, so a share card uses only those); 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; filter with `control`, each item may carry a `display` label), `setSourceControl`, `onSourceControlChange`, `reportSource`. Delegated accounts: `nativeSocialAccounts`, `startNativeSocialConnection`, `finishNativeSocialConnection`, `disconnectNativeSocialAccount`. Native follows: `nativeFollowStates` (every connected account's state for one source, one read), `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`; radar stories: `getPublicRadarStory` (one story by id with its posts; one that left the radar within its minimum lifetime, or within the last half hour, still answers live with `liveUntil` and the story that continues it; one that has left for longer comes with its archived copy and the live story it continues as; the id may be a World Today edition story's, and the answer then names it in `editionStory` under the story's radar id), keyless `getSharedRadarStory(projectId, { cluster })` and `getSharedRadarPosts(projectId, { cluster })` (keyless reads carry images and videos only from outlets and members marked `visitorMedia`; signed-in reads keep all media, so a share card uses only those); the Viral read (fastest-moving posts across Bluesky, the Fediverse, Nostr and Minds, each against its own network's pace; 0.7.59): `getPublicViral({ network?, category?, media?: 'video', limit?: 5 | 10 | 20 | 40, cursor?, compass? })` under the member's key and keyless `getSharedViral(projectId, params)` (visitors: `compass` `all` or `hide` only; a visitor's `media: 'video'` read can carry items whose video the server withheld, so filter with the exported `viralItemHasVideo` before a video player; `item.post` narrows on `item.protocol`). `status: 'off'` resolves with no items until the app enables the read, and `getSharedViral` also resolves an older API's 401 `missing_api_key` as off; `getPublicViral` throws every 401 and 403, so a session failure is never read as off; 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/`.
 
@@ -364,7 +364,7 @@ try {
 }
 ```
 
-Auto-retry is built in. 429 and 5xx responses retry with exponential backoff (configurable via `maxRetries`, default 2). A 429 with `X-RateLimit-Scope: action` refuses one member action past its budget and is never retried: its `RateLimitError` has `scope: 'action'` and `resetAt` (a `Date`, when that action's budget reopens).
+Auto-retry is built in. 429 and 5xx responses retry with exponential backoff (configurable via `maxRetries`, default 2). A 429 with `X-RateLimit-Scope: action` refuses one member action past its budget and is never retried: its `RateLimitError` has `scope: 'action'` and `resetAt` (a `Date`, when that action's budget reopens). A read that holds its own deadline can ask once with `retry: false` in its params: `r.posts.list({ ...params, retry: false })` and `r.curator.forYou({ ...params, retry: false })` throw the first 5xx or 429 with no retry and no `Retry-After` sleep, and never send `retry` to the server.
 
 ## Pagination
 
@@ -664,6 +664,14 @@ and says whether the member is personalized yet (`meta.personalized`). With a
 `category` (the member's first), the session also reads open-network posts from it;
 without, it is Minds only. It never carries the radar.
 
+Both take a Politics choice, `compass` (`all`, `mix`, `hide`, or cells in the order
+`lo,co,ro,lm,cm,rm,ll,cl,rl`, optionally `np`), and send it with every Minds read
+(`posts.list` and `curator.forYou` take it too). Each such page says what it did in
+`meta.compass_filter` (`status` `applied` or `unavailable`, and counts only), and each session
+page carries its Minds read's answer as `page.compass` (`unavailable`: the page is unfiltered). Only Minds
+posts are filtered, so a view that leaves posts out reads best with `source: 'minds'`.
+The catalog lists `compass_filter` on every network when the filter is served to the viewer.
+
 `sdk.discovery.recommendations({ kind, category?, limit?, session?, exclude? })` is
 the app's one recommender for suggestion rails: `kind` is `member`, `group`, `tag`,
 `network_account` or `story`, and `category` is `all` or a browse category id. It
@@ -689,7 +697,11 @@ category, refreshed after 30 s, kept up to 300 s and warmed as the warmer reache
 viewer's `people` and `groups`; a section that timed out, failed or is off is empty with a
 `reason` for that request only (a failure is never cached, so asking again retries it), and one this
 key may not read is empty with `refused` (`stories` and `network` need the member's own app
-key with `users:read`; `people` and `groups` need `users:read`). A plain category page
+key with `users:read`; `people` and `groups` need `users:read`). `sdk.discovery.videos({ category?, limit?, cursor?, offset? })`
+is Watch's Minds read: the app's public video posts in hot order, from one list the server shares among every viewer of
+the app and rebuilds about once a minute, each post checked again on every call under the public floors and the viewer's
+blocks and mutes, in the `Post` shape with the viewer's own `user_reaction` and `reposted_by_viewer_id` (page on
+`meta.next_cursor`; a feed session's Minds slot can read it as its `list`). A plain category page
 (`posts.list({ category })` with no other filter) reads on past a slice the safety floors
 thinned, up to six reads, until it holds `limit` posts or its candidates end: `meta.scanned`
 is how many it examined (the next offset is `offset + scanned`), and the stage ends on the

package/dist/errors.d.ts

@@ -84,3 +84,16 @@ export declare class RateLimitError extends RecursivError {
 export declare class ConflictError extends RecursivError {
     constructor(body: ApiErrorBody['error']);
 }
+/**
+ * `email.send` answered 200 but sent to nobody: every recipient was held
+ * (no marketing consent, suppressed, preference off). Thrown so a caller that
+ * only checks for success cannot report mail as sent. `details` carries the
+ * per-recipient `messages` with each `reason`.
+ */
+export declare class EmailNotSentError extends RecursivError {
+    constructor(body: {
+        message: string;
+        hint?: string;
+        details?: unknown;
+    });
+}

package/dist/errors.js

@@ -189,3 +189,15 @@ export class ConflictError extends RecursivError {
         this.name = 'ConflictError';
     }
 }
+/**
+ * `email.send` answered 200 but sent to nobody: every recipient was held
+ * (no marketing consent, suppressed, preference off). Thrown so a caller that
+ * only checks for success cannot report mail as sent. `details` carries the
+ * per-recipient `messages` with each `reason`.
+ */
+export class EmailNotSentError extends RecursivError {
+    constructor(body) {
+        super(200, { type: 'email_not_sent', code: 'email_held', message: body.message, hint: body.hint, details: body.details });
+        this.name = 'EmailNotSentError';
+    }
+}

package/dist/index.d.ts

@@ -154,12 +154,12 @@ export { UsersResource } from './resources/users.js';
 export { CommunitiesResource } from './resources/communities.js';
 export { ChatResource } from './resources/chat.js';
 export { E2eeResource } from './resources/e2ee.js';
-export type { E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelope, E2eeEvent, E2eeHasDependentsDetails, E2eeKeyPackageStatus, E2eeLink, E2eeLinkCancelledBy, E2eeLinkProgress, E2eeLinkRealtimeEvent, E2eeLinkState, E2eeObjectDownload, E2eeObjectUpload, E2eeRealtimeEvent, E2eeRevokeResponse, E2eeStatus, E2eeStatusReason, } from './resources/e2ee.js';
+export type { E2eeAccountReset, E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelope, E2eeEvent, E2eeHasDependentsDetails, E2eeKeyPackageStatus, E2eeLink, E2eeLinkCancelledBy, E2eeLinkProgress, E2eeLinkRealtimeEvent, E2eeLinkState, E2eeObjectDownload, E2eeObjectUpload, E2eeRealtimeEvent, E2eeResetCodeSent, E2eeResetErrorCode, E2eeRevokeResponse, E2eeStatus, E2eeStatusReason, } from './resources/e2ee.js';
 export { ProjectsResource } from './resources/projects.js';
 export { AgentsResource, SUPPORTED_MODELS } from './resources/agents.js';
 export { EvidenceResource } from './resources/evidence.js';
 export type { EvidenceTarget, EvalType, CreateEvalInput, SimulateInput, SimulateResult, EvalRunRow, EvalResultRow, EvalRunDetail, EvidenceSummary, EvidenceEvent, EvidenceRecordDetail } from './resources/evidence.js';
-export type { AgentMessage, AgentMessageInput, AgentInboxParams, SupportedModel, SalesLead, SalesLeadListParams, SalesLeadStatus } from './resources/agents.js';
+export type { AgentMessage, AgentMessageInput, AgentInboxParams, AgentAskInput, AgentAskResult, SupportedModel, SalesLead, SalesLeadListParams, SalesLeadStatus } from './resources/agents.js';
 export { TagsResource } from './resources/tags.js';
 export { SandboxResource } from './resources/sandbox.js';
 export { ProfilesResource } from './resources/profiles.js';
@@ -173,6 +173,7 @@ export { InviteCodesResource } from './resources/invite-codes.js';
 export { InviteCodesAdminResource } from './resources/invite-codes-admin.js';
 export { AdminResource } from './resources/admin.js';
 export { EmailResource } from './resources/email.js';
+export type { SendEmailInput, SendEmailResult, SendEmailMessage } from './resources/email.js';
 export { StorageResource } from './resources/storage.js';
 export { DatabasesResource } from './resources/databases.js';
 export { EnvVarsResource } from './resources/env-vars.js';
@@ -194,7 +195,7 @@ export type { CuratorSource, CuratorPrompt, CuratorRunInput, CuratorRunResult, C
 export { ReportsResource } from './resources/reports.js';
 export type { ReportTargetType, ReportStatus, CreateReportInput, ReportRecord, ResolveReportInput, } from './resources/reports.js';
 export { ModerationResource } from './resources/moderation.js';
-export type { ModerationTargetType, ModerationActionType, ModerationAppealStatus, ModerationPrinciple, PublicModerationAction, PublicModerationLog, OwnModerationAppeal, OwnModerationAction, OwnModerationLog, ApplyModerationActionInput, } from './resources/moderation.js';
+export type { ModerationTargetType, ModerationActionType, ModerationAppealStatus, ModerationPrinciple, PublicModerationAction, PublicModerationLog, OwnModerationAppeal, OwnModerationAction, OwnModerationLog, ApplyModerationActionInput, AgentModerationMode, AgentModerationGrant, } from './resources/moderation.js';
 export { LinkPreviewResource } from './resources/link-preview.js';
 export { SEARCH_SECTIONS, SearchResource } from './resources/search.js';
 export type { SearchAnswer, SearchGroup, SearchOmitReason, SearchParams, SearchPerson, SearchRelated, SearchResponse, SearchSection, SearchStory, SearchTopic } from './resources/search.js';
@@ -214,8 +215,8 @@ export type { LinkedTokenWallet, PayoutState, TokenBalance, TokenLedgerEntry } f
 export { BoostsResource } from './resources/boosts.js';
 export type { BoostBalance, BoostBalanceResponse, BoostCampaign, BoostCampaignResponse, BoostEventResult, BoostLedgerEntry, BoostLedgerKind, BoostPlanCredit, BoostRejectionReason, BoostReviewStatus, BoostStatus, BoostTopupCheckout, BoostTopupConfirmation, BoostTopupLimits, } from './resources/boosts.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, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarPosts, SocialRadarStory, SocialRadarStoryArchive, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendSourceIndex, 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, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostHistory, NativeDelegatedPostHistoryItem, NativeNostrPostHistoryItem, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowAccount, NativeFollowStates, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlDisplay, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, CreateHostedIdentityInput, CreatedHostedProtocolIdentity, 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 { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, viralItemHasVideo, } from './resources/protocols.js';
+export type { SocialProfile, SocialBridge, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarPosts, SocialRadarStory, SocialRadarStoryArchive, ViralBaseline, ViralItem, ViralItemFields, ViralItemSpread, ViralItemVelocity, ViralLabel, ViralMindsCard, ViralMindsItem, ViralNetwork, ViralOpenProtocol, ViralProtocol, ViralProvider, ViralReadMeta, ViralReadParams, ViralReadResponse, ViralReadStatus, ViralRef, ViralSocialItem, SocialNetwork, SocialPost, SocialConversation, SocialTrend, SocialTrendProvenance, SocialTrends, SocialTrendSourceIndex, 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, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostHistory, NativeDelegatedPostHistoryItem, NativeNostrPostHistoryItem, NativeFollowSourceInput, NativeFollowPrepareInput, NativeFollowTarget, NativeFollowReceipt, NativeFollowState, NativeFollowAccount, NativeFollowStates, NativeFollowReview, NativeLikeSourceInput, NativeRepostSourceInput, NativeLikePrepareInput, NativeRepostPrepareInput, NativeLikeTarget, NativeRepostTarget, NativeLikeReceipt, NativeRepostReceipt, NativeLikeState, NativeRepostState, NativeLikeReview, NativeRepostReview, NativeReplyReceipt, NativeReplyBatch, NativeReplyHistory, NativeDelegatedReplyHistoryItem, NativeNostrReplyResult, NativeNostrReplyHistoryItem, NativeReplyRemovalReceipt, NativeReplyRemovalPreview, SocialSourceRef, SocialSourceControl, SocialSourceControlDisplay, SocialSourceControlChange, HostedPostPreview, ConnectHostedIdentityInput, CreateHostedIdentityInput, CreatedHostedProtocolIdentity, 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';
@@ -240,7 +241,7 @@ export { TemplatesResource } from './resources/templates.js';
 export type { Template, CreateTemplateInput, UpdateTemplateInput, ListTemplatesParams } from './resources/templates.js';
 export { MediaResource } from './resources/media.js';
 export type { GenerateImageInput, GeneratedImage, ImageProvider } from './resources/media.js';
-export { RecursivError, AuthenticationError, AuthorizationError, LegacyHandoffError, NotFoundError, ValidationError, InsufficientCreditsError, RateLimitError, ConflictError, isActionRateLimitScope, } from './errors.js';
+export { RecursivError, AuthenticationError, AuthorizationError, LegacyHandoffError, NotFoundError, ValidationError, InsufficientCreditsError, RateLimitError, ConflictError, isActionRateLimitScope, EmailNotSentError, } from './errors.js';
 export type { RateLimitDetails } from './errors.js';
 export { parseSSE } from './lib/sse.js';
 export * from './lib/webhooks.js';

package/dist/index.js

@@ -261,7 +261,7 @@ export { UploadsResource } from './resources/uploads.js';
 export { WalletResource } from './resources/wallet.js';
 export { BoostsResource } from './resources/boosts.js';
 export { ProtocolsResource } from './resources/protocols.js';
-export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, } from './resources/protocols.js';
+export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, viralItemHasVideo, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';
 export { NetworkResource } from './resources/network.js';
 export { SimulatorResource } from './resources/simulator.js';
@@ -277,6 +277,6 @@ export { HumanInputResource } from './resources/human-input.js';
 export { SwarmsResource } from './resources/swarms.js';
 export { TemplatesResource } from './resources/templates.js';
 export { MediaResource } from './resources/media.js';
-export { RecursivError, AuthenticationError, AuthorizationError, LegacyHandoffError, NotFoundError, ValidationError, InsufficientCreditsError, RateLimitError, ConflictError, isActionRateLimitScope, } from './errors.js';
+export { RecursivError, AuthenticationError, AuthorizationError, LegacyHandoffError, NotFoundError, ValidationError, InsufficientCreditsError, RateLimitError, ConflictError, isActionRateLimitScope, EmailNotSentError, } from './errors.js';
 export { parseSSE } from './lib/sse.js';
 export * from './lib/webhooks.js';

package/dist/resources/agents.d.ts

@@ -26,6 +26,68 @@ export interface AgentInboxParams {
     limit?: number;
     offset?: number;
 }
+export interface AgentAskInput {
+    organization_id: string;
+    /** The person whose agent you are asking: name, first name, @username, email or user id. */
+    owner: string;
+    question: string;
+    /** How far back to read their record (1-90, default 7). */
+    since_days?: number;
+    /** false = read the record only, leave nothing in their agent's inbox. */
+    deliver?: boolean;
+}
+export interface AgentAskResult {
+    owner: {
+        id: string;
+        name: string | null;
+        username: string | null;
+    };
+    agents: Array<{
+        id: string;
+        name: string;
+        client: string | null;
+    }>;
+    window: {
+        since: string;
+        days: number;
+    };
+    record: {
+        claims: Array<{
+            task_id: string;
+            task_title: string;
+            task_status: string;
+            agent: string;
+            claim_status: string;
+            claimed_at: string;
+            completed_at: string | null;
+            released_at: string | null;
+            release_reason: string | null;
+            notes: string | null;
+            context_handoff: string | null;
+            pr_urls: string[] | null;
+            commits: string[] | null;
+        }>;
+        decisions: Array<{
+            id: string;
+            decision: string;
+            context: string | null;
+            tags: string[] | null;
+            project_id: string | null;
+            created_at: string;
+        }>;
+    };
+    question: {
+        delivered: true;
+        message_id: string;
+        to_agent_id: string;
+        to_agent_name: string;
+        from_agent_id: string;
+    } | {
+        delivered: false;
+        reason: string;
+    };
+    how_to_answer: string;
+}
 export interface AgentLeaderboardParams extends PaginationParams {
     organization_id?: string;
 }
@@ -264,6 +326,14 @@ export declare class AgentsResource {
     }>>;
     /** Send a direct message to an agent */
     sendMessage(toAgentId: string, input: AgentMessageInput): Promise<SingleResponse<AgentMessage>>;
+    /**
+     * Ask a teammate's agent by naming its owner ("bill", "@ottman", an email).
+     * Returns that person's agents' work in the organization over the window
+     * (task claims with notes, handoffs, PRs and commits; decisions) and leaves
+     * the question in their agent's inbox; its reply arrives in yours as a
+     * `result` message with `metadata.in_reply_to`.
+     */
+    ask(input: AgentAskInput): Promise<SingleResponse<AgentAskResult>>;
     /** Get an agent's inbox (messages sent to them) */
     inbox(agentId: string, params?: AgentInboxParams): Promise<SingleResponse<AgentMessage[]>>;
     /** Get unread message count for an agent */

package/dist/resources/agents.js

@@ -172,6 +172,16 @@ export class AgentsResource {
     sendMessage(toAgentId, input) {
         return this.client.post(`/agents/${toAgentId}/messages`, input);
     }
+    /**
+     * Ask a teammate's agent by naming its owner ("bill", "@ottman", an email).
+     * Returns that person's agents' work in the organization over the window
+     * (task claims with notes, handoffs, PRs and commits; decisions) and leaves
+     * the question in their agent's inbox; its reply arrives in yours as a
+     * `result` message with `metadata.in_reply_to`.
+     */
+    ask(input) {
+        return this.client.post('/agents/ask', input);
+    }
     /** Get an agent's inbox (messages sent to them) */
     inbox(agentId, params) {
         return this.client.get(`/agents/${agentId}/inbox`, params);

package/dist/resources/curator.d.ts

@@ -11,6 +11,10 @@ export type ForYouParams = {
     discovery?: boolean;
     /** `discover` ranks for Discover: fresher, beyond the member's follows, with their category order. */
     surface?: ForYouSurface;
+    /** A Politics choice, as `posts.list` takes it (`ListPostsParams.compass`); the page says what it did in `meta.compass_filter`. */
+    compass?: string;
+    /** `false` asks once and is never sent, as `posts.list` takes it (`ListPostsParams.retry`). */
+    retry?: boolean;
 };
 export interface ForYouMeta extends PaginationMeta {
     discovery?: DiscoveryLayout;
@@ -269,7 +273,7 @@ export declare class CuratorResource {
      * affinity, no model calls). Returns posts in the same shape as
      * `sdk.posts.list()`, so any feed UI renders it unchanged. Requires a
      * project-scoped key (the feed is per-app). Servers that predate `cursor`,
-     * `discovery` and `surface` ignore them.
+     * `discovery` and `surface` ignore them. `retry: false` asks once and is never sent (`ListPostsParams.retry`).
      */
     forYou(params?: ForYouParams): Promise<PaginatedResponse<Post> & {
         meta: ForYouMeta;

package/dist/resources/curator.js

@@ -48,9 +48,13 @@ export class CuratorResource {
      * affinity, no model calls). Returns posts in the same shape as
      * `sdk.posts.list()`, so any feed UI renders it unchanged. Requires a
      * project-scoped key (the feed is per-app). Servers that predate `cursor`,
-     * `discovery` and `surface` ignore them.
+     * `discovery` and `surface` ignore them. `retry: false` asks once and is never sent (`ListPostsParams.retry`).
      */
     forYou(params = {}) {
-        return this.client.get('/curator/foryou', params);
+        // Without `retry`, the same request older SDKs make.
+        if (!('retry' in params))
+            return this.client.get('/curator/foryou', params);
+        const { retry, ...query } = params;
+        return retry === false ? this.client.get('/curator/foryou', query, { retry: false }) : this.client.get('/curator/foryou', query);
     }
 }

package/dist/resources/discovery.d.ts

@@ -1,10 +1,69 @@
 import type { HttpClient } from '../client.js';
-import type { DiscoveryLayout, FalloverStep, Post } from '../types.js';
+import type { CompassFilterMeta, DiscoveryLayout, FalloverStep, MediaItem, Post } from '../types.js';
 import type { CuratorResource } from './curator.js';
 import type { DiscoveryLearning } from './discovery-learning.js';
 import type { PostsResource } from './posts.js';
 import type { ProtocolsResource, SocialNetwork, SocialPost, SocialRadar, SocialRadarPosts } from './protocols.js';
 export type DiscoveryRecommendationKind = 'groups' | 'people' | 'tags';
+/** A page of Watch's Minds videos (`discovery.videos`). */
+export interface WatchVideosParams {
+    /** A browse category id: the videos among the category's judged posts. Omitted: the whole app. */
+    category?: string;
+    /** Posts per page, 1 to 25 (default 12). */
+    limit?: number;
+    /** The `meta.next_cursor` of the page before. */
+    cursor?: string;
+    /** A position in the list to start a first read at (0 to 400); a later page sends `cursor`. */
+    offset?: number;
+}
+/** A media item as `discovery.videos` serves it: the poster, and the player's size, length and HLS address when known. */
+export interface WatchVideoMedia extends MediaItem {
+    thumbnail_url: string | null;
+    /** Set while the file is not ready on the CDN; absent once it is. */
+    status?: string;
+    width?: number;
+    height?: number;
+    duration_sec?: number;
+    hls_url?: string;
+}
+/**
+ * A post as `discovery.videos` serves it: the `Post` shape (so a page is a valid `posts.list` page), with the engagement
+ * GET /posts sends (live votes plus imported likes, the replies the reader can open) and the viewer's own vote and repost.
+ */
+export interface WatchVideoPost extends Post {
+    title: string | null;
+    is_nsfw: boolean;
+    score: number;
+    upvote_count: number;
+    downvote_count: number;
+    /** The viewer's own reaction ('upvote', 'downvote', ...); null for a visitor or when they have none. */
+    user_reaction: string | null;
+    reply_count: number;
+    reply_count_external: number;
+    unique_commenters: number;
+    reposts_count: number;
+    /** Id of the viewer's own repost of the post; delete it to undo the repost. */
+    reposted_by_viewer_id: string | null;
+    media: WatchVideoMedia[];
+}
+export interface WatchVideosResponse {
+    /** Public Minds video posts in hot order (with the viewer's own `user_reaction` and `reposted_by_viewer_id`). */
+    data: WatchVideoPost[];
+    meta: {
+        limit: number;
+        /** The position in the list this page started at. */
+        offset: number;
+        has_more: boolean;
+        /** Pass as `cursor` for the next page; null at the end of the list. */
+        next_cursor: string | null;
+        /** Positions in the list this page examined (a client paging by offset adds it to the offset). */
+        scanned: number;
+        /** When the shared list the page was cut from was built; null when the app has none. */
+        built_at: string | null;
+        /** `no_app`: the API key is bound to no app, so there is no list. */
+        reason?: 'no_app';
+    };
+}
 /** What GET /discover/recommendations suggests: members, groups, tags, open-network accounts or World Today stories. */
 export type EntityKind = 'member' | 'group' | 'tag' | 'network_account' | 'story';
 /**
@@ -280,6 +339,12 @@ export interface DiscoveryFeedPage {
      * on servers that predate it.
      */
     fallover?: FalloverStep[];
+    /**
+     * What the session's Politics choice (`compass`, createFeed and createPersonalFeed) did to this page's Minds read:
+     * that read's `meta.compass_filter`, counts only. `unavailable` means the page was served unfiltered. Absent without
+     * a choice, on a page whose Minds read failed or was not made, and on servers that predate the filter.
+     */
+    compass?: CompassFilterMeta;
 }
 /** A gallery strip holds up to twelve image posts gathered from the whole page. */
 export declare const GALLERY_MAX_ITEMS = 12;
@@ -369,6 +434,16 @@ export declare class DiscoveryResource {
     }, options?: {
         retry?: boolean;
     }): Promise<CategorySurfaceResponse>;
+    /**
+     * Watch's Minds videos for the viewer: the app's public video posts in hot order (engagement decayed by age), from
+     * one list the server shares among every viewer of the app and rebuilds about once a minute, each post checked again
+     * on every read under the public floors (not NSFW, removed or hidden; no spam-labelled or adult author or group; the
+     * cached safety verdict) and the viewer's blocks and mutes. A video whose file is gone or not on the CDN yet is left
+     * out or marked `unplayable`. Page on `meta.next_cursor`. Needs posts:read; the app is the API key's project.
+     */
+    videos(params?: WatchVideosParams, options?: {
+        retry?: boolean;
+    }): Promise<WatchVideosResponse>;
     /**
      * A For you Discover feed: the member's For You ranking (asked for Discover's surface, with layouts and a
      * snapshot cursor) in a session's Minds slot. With a category, the session also reads open-network posts
@@ -380,12 +455,19 @@ export declare class DiscoveryResource {
         learning?: DiscoveryLearning;
         recommend?: DiscoveryRecommendationSources;
         category?: string;
+        compass?: string;
     }): DiscoveryFeedSession;
+    /**
+     * Discover's feed session. `compass` (a Politics choice, as `posts.list` takes it) goes on every Minds read, whose
+     * pages then carry `meta.compass_filter`; the open networks' reads and the radar are not filtered by it, so a view
+     * that leaves posts out (Hide politics, Choose sides) is best read with `source: 'minds'`.
+     */
     createFeed(options: {
         networks: SocialNetwork[];
         category?: string;
         source?: string;
         learning?: DiscoveryLearning;
         recommend?: DiscoveryRecommendationSources;
+        compass?: string;
     }): DiscoveryFeedSession;
 }

package/dist/resources/discovery.js

@@ -191,7 +191,12 @@ export class DiscoveryFeedSession {
         if (stream.protocol === 'minds') {
             // Discover leads with what is moving now: the REST hot order (engagement
             // decayed by age). Hot pages by offset; the server sends no cursor for it.
-            const response = await this.posts.list({ ...params, sort: 'hot', ...(stream.cursor ? { cursor: stream.cursor } : { offset: stream.offset }) });
+            // Asked once, as the open networks are: a 503 retried twice with its Retry-After ran past this read's 15 s
+            // deadline, and the Minds lane failed (Bill 2026-10-01: "couldnt load discover minds posts didnt load"). The
+            // opt-out rides in the params (ListPostsParams.retry), which a reader handed to a session forwards to read the
+            // right page at all: a second argument was dropped by the Minds app's own wrappers (lib/discoverFeedResource,
+            // lib/compassStatus withCompass, lib/watchSource), which pass the params alone (review of #4047).
+            const response = await this.posts.list({ ...params, sort: 'hot', ...(stream.cursor ? { cursor: stream.cursor } : { offset: stream.offset }), retry: false });
             stream.offset += response.meta.scanned ?? response.meta.limit;
             const next = response.meta.next_cursor ?? undefined;
             stream.done = !response.meta.has_more || !!next && (next === stream.cursor || stream.used.includes(next));
@@ -202,7 +207,8 @@ export class DiscoveryFeedSession {
             if (Array.isArray(response.meta.fallover))
                 stream.fallover = response.meta.fallover;
             return { items: response.data.map(post => ({ key: key('minds', post.id), kind: 'minds', post })),
-                layout: response.meta.discovery ?? ordinary, partial: response.meta.category_filter?.status === 'partial' };
+                layout: response.meta.discovery ?? ordinary, partial: response.meta.category_filter?.status === 'partial',
+                ...(response.meta.compass_filter ? { compass: response.meta.compass_filter } : {}) };
         }
         const validatePosts = (data) => {
             if (data.coverage !== 'provider_ranked_window' || data.items.length > 25 || data.items.some(post => post.protocol !== stream.protocol || post.author.protocol !== stream.protocol))
@@ -402,9 +408,11 @@ export class DiscoveryFeedSession {
         if (cluster)
             modules.splice(page === 0 ? 0 : Math.min(2, modules.length), 0, this.radarModule(page, cluster, clusterItems));
         const fallover = this.streams.find(stream => stream.protocol === 'minds')?.fallover;
+        // Only the Minds read carries what a Politics choice did (the open networks' reads are not filtered by it).
+        const compass = reads.find(read => read.compass)?.compass;
         return { modules, hasMore: this.streams.some(stream => !stream.done && !stream.failed),
             failedSources: this.streams.filter(stream => stream.failed).map(stream => stream.protocol), partialCategories: reads.some(read => read.partial),
-            ...(fallover ? { fallover } : {}) };
+            ...(fallover ? { fallover } : {}), ...(compass ? { compass } : {}) };
     }
     /** Page 0: the top breaking cluster, else the top cluster. Every second later page: the next unused story or viral cluster. */
     async radarCluster(page) {
@@ -583,6 +591,18 @@ export class DiscoveryResource {
             throw new Error('category needs the HTTP client');
         return this.http.get('/discover/category', params, options);
     }
+    /**
+     * Watch's Minds videos for the viewer: the app's public video posts in hot order (engagement decayed by age), from
+     * one list the server shares among every viewer of the app and rebuilds about once a minute, each post checked again
+     * on every read under the public floors (not NSFW, removed or hidden; no spam-labelled or adult author or group; the
+     * cached safety verdict) and the viewer's blocks and mutes. A video whose file is gone or not on the CDN yet is left
+     * out or marked `unplayable`. Page on `meta.next_cursor`. Needs posts:read; the app is the API key's project.
+     */
+    videos(params = {}, options) {
+        if (!this.http)
+            throw new Error('videos needs the HTTP client');
+        return this.http.get('/discover/videos', { ...params }, options);
+    }
     /**
      * A For you Discover feed: the member's For You ranking (asked for Discover's surface, with layouts and a
      * snapshot cursor) in a session's Minds slot. With a category, the session also reads open-network posts
@@ -593,10 +613,13 @@ export class DiscoveryResource {
         const curator = this.curator;
         if (!curator)
             throw new Error('createPersonalFeed needs the curator resource');
+        const compass = options.compass;
         const list = {
-            // The session's `sort` and `category` are Discover's hot-order knobs; the ranker ignores them.
+            // The session's `sort` and `category` are Discover's hot-order knobs; the ranker ignores them. A Politics choice
+            // goes on every ranker read.
             list: async (params) => {
-                const response = await curator.forYou({ limit: params?.limit, offset: params?.offset, cursor: params?.cursor, discovery: true, surface: 'discover' });
+                const response = await curator.forYou({ limit: params?.limit, offset: params?.offset, cursor: params?.cursor, discovery: true, surface: 'discover',
+                    ...(compass ? { compass } : {}), ...(params?.retry === undefined ? {} : { retry: params.retry }) });
                 // A server that predates the cursor says has_more: false on a partial ranked page although its
                 // continuation serves the next offset. A cursor-aware server always says `personalized`, and its
                 // has_more is the end of the feed.
@@ -606,9 +629,16 @@ export class DiscoveryResource {
         };
         return new DiscoveryFeedSession(list, this.protocols, options.category ? options.networks : [], options.category, options.category ? 'all' : 'minds', options.learning, options.recommend);
     }
+    /**
+     * Discover's feed session. `compass` (a Politics choice, as `posts.list` takes it) goes on every Minds read, whose
+     * pages then carry `meta.compass_filter`; the open networks' reads and the radar are not filtered by it, so a view
+     * that leaves posts out (Hide politics, Choose sides) is best read with `source: 'minds'`.
+     */
     createFeed(options) {
+        const compass = options.compass;
+        const posts = compass ? { list: params => this.posts.list({ ...params, compass }) } : this.posts;
         // The radar rides along by default; an older server answers 404 and the session simply shows no story module.
-        return new DiscoveryFeedSession(this.posts, this.protocols, options.networks, options.category, options.source, options.learning, options.recommend, params => this.protocols.getPublicRadar(params, NO_RETRY), { social: params => this.protocols.getPublicRadarPosts(params, NO_RETRY), minds: id => this.posts.get(id) });
+        return new DiscoveryFeedSession(posts, this.protocols, options.networks, options.category, options.source, options.learning, options.recommend, params => this.protocols.getPublicRadar(params, NO_RETRY), { social: params => this.protocols.getPublicRadarPosts(params, NO_RETRY), minds: id => this.posts.get(id) });
     }
 }
 /** A read bounded to three seconds; a late or failed one resolves to `fallback`, never an error. */