@recursiv/sdk 0.7.152 → 0.7.195

package/README.md

@@ -68,7 +68,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.databases` | `ensure`, `create`, `list`, `getCredentials`, `query` |
 | `r.envVars` | `set`, `list`, `delete` (values write-only; secrets masked on read) |
 | `r.projects` | `create`, `deploy`, `executeCode`, `createSandbox`, `stopSandbox`, `deploymentLogs` |
-| `r.deployments` | Operator release coordination: `reserveRelease`, `getRelease`, `advanceRelease`, `startRelease`, `finishRelease`, `recoverRelease`; follow the [shared release guide](../../docs/deploy/shared-releases.md) |
+| `r.deployments` | Operator release coordination: `reserveRelease` (optional initial-run `coordinator_identity_token` after compatible API rollout), `getRelease`, `advanceRelease`, `startRelease`, `finishRelease`, `recoverRelease`; follow the [shared release guide](../../docs/deploy/shared-releases.md) |
 | `r.storage` | `ensureBucket`, `getUploadUrl`, `getDownloadUrl`, `listItems`, `deleteObject` |
 | `r.telemetry` | `productCounts` — app-bound first-party aggregate counts; reviewed event names and counts only, retained at most 30 days |
 | `r.sandbox` | `execute` (anonymous, no API key needed) |
@@ -96,9 +96,10 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | Resource | Key methods |
 |----------|------------|
 | `r.posts` | `create`, `update`, `list`, `get`, `getMany(ids)` (up to 25 posts by id per request, no thread; a `Map` of each id's post or `NotFoundError`; 0.7.77), `liked`, `bookmarked`, `bookmark`, `unbookmark`, `search`, `replies`, `react` |
-| `r.search` | `query` (blended search in sections; a thin answer steps down the search ladder, each item labelled `via`, the answer's `ladder` says how) |
+| `r.search` | `query` (blended search in sections; a thin answer steps down the search ladder, each item labelled `via`, the answer's `ladder` says how). A visitor's search posts (`publicDiscovery.search`, `PublicSearchPage`) may carry `picture` (`SearchPicture`, 0.7.162): `kind`, `textHeavy`, `tileQuality` (0-3) and an optional `focal` point, layout hints from a background read of pictures the floors cleared, absent until judged and never a safety signal; on the `deep` stage `picture.showsQuery` (0.7.190) says whether the picture itself shows the query, absent unless the operator turned on `SEARCH_PICTURE_SUBJECT`. Both answers may carry `video_lead` (`SearchVideoLeadEntry[]`, 0.7.173): every clip in the order to lead and play it, the most about the words first, then the freshest, a Minds member's clip winning a tie |
 | `r.bookmarks` | `save`, `unsave`, `posts`, `list`, `keys`, `merge` — the member's saved posts, open-network posts and articles, synced across devices; `collections`: `list`, `create`, `update`, `remove`, `add`, `removeItem`, `items`, `posts` — private named collections of saves (0.7.68, where `network.getConfig()` advertises `capabilities.bookmark_collections`) |
-| `r.feeds` | `top` (what the member is most likely to engage with, rotated by what they saw, with open-network lanes and the lead story), `stories` (the story tail), `publicTop` (a visitor's top, keyless and edge-cacheable) |
+| `r.feeds` | `top` (what the member is most likely to engage with, rotated by what they saw, with open-network lanes and the lead story), `stories` (the story tail), `publicTop` (a visitor's top, keyless and edge-cacheable), `firehose` (0.7.195: the member's live stream of the most engaged, viral and breaking posts, never repeated in a session) |
+| `r.alive` | `tick({ followingSince?, posts?, thread? })` (0.7.193; the member's own app key, `users:read`; 404 `alive_disabled` until the operator sets `ALIVE_TICK_ENABLED`): whether anyone the member follows posted since the newest row they hold (`following.fresh`), the current counts of up to 30 posts on screen they may see, the new replies under the open post (their own left out), and `nextAfterMs` (when to tick next). Asked once; at most 4 a minute |
 | `r.communities` | `create`, `join`, `search`, `members` |
 | `r.chat` | `send`, `dm`, `createGroup` (`encrypted: true` for an end-to-end encrypted group, 0.7.59), `messages` (cursor paging), `acceptRequest`, `declineRequest`, `leave`, `deleteConversation`; a private group's admin: `addMembers`, `removeMember`, `updateGroup` (0.7.59); photos and voice notes: `uploadAttachment`, `signAttachments` (private chat storage, 0.7.82) |
 | `r.tags` | `create`, `list` |
@@ -118,7 +119,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.settings` | User preferences (including app-scoped content choices; per-kind notification settings in `notifications.channels`, set one kind with `updateNotifications({ channels: { post_reaction: { push: false } } })`, 0.7.72), sessions (`revokeOtherSessions` keeps this device), password management, email change (`requestConfirmationCode` for accounts with no password), deactivation (`disableAccount({ password })`, 0.7.71; 404 on an API that does not serve it) |
 | `r.billing` | Usage tracking, subscriptions, checkout |
 | `r.appSubscriptions` | Consumer app plans: `checkout`, `status`, `createPortalSession`, `previewTierChange`, `changeTier` |
-| `r.boosts` | Promoted posts: `create`, `mine`, `balance`, `pause`, `resume`, `cancel`, `recordEvent`, `topup`, `confirmTopup`; admin `listPendingReview`, `review`, `grant` |
+| `r.boosts` | Promoted posts: `create`, `mine`, `balance`, `pause`, `resume`, `cancel`, `recordEvent`, `stats`, `topup`, `confirmTopup`, `topupWithTokens`; a feed page's boosts `slots` / `publicSlots` (splice with `spliceBoostSlots`); admin `listPendingReview`, `review`, `grant` |
 | `r.wallet` | Wallet, MINDS tokens (`getTokenBalance`, `getTokenLedger`), a wallet the member holds linked by signature (`createLinkNonce`, `linkWallet`, `listLinkedWallets`, `unlinkWallet`), USD payouts (`getPayouts`, `startPayoutOnboarding`, `payoutLoginLink`) |
 | `r.notifications` | Notification stream (`list`, `unreadCount`, `markAsRead`, `archive`, `markAllAsRead`; `category: 'mentions'` for mentions and replies only, 0.7.72) and push tokens |
 | `r.github` | GitHub integration |
@@ -130,7 +131,7 @@ for await (const chunk of r.agents.chatStream(agent.id, { message: 'Hello!' }))
 | `r.goals` | Org goals with task rollups (group dispatcher tasks) |
 | `r.media` | `sourceApprovals({ projectId, sources })` — cached public host/purpose judgments and exact owned hosts; no caller-triggered provider fetch or inference. Image/icon requests stay relayed; direct players use approved, unexpired decisions once enforcement is active |
 | `r.linkPreview` | `get(url, source?, { projectId })` opts into expiring relayed image/icon capabilities; refresh before `media_expires_at`, and preserve source authorization. `get(url)` — a public link's Open Graph card (`data: null` when it has none). For a chat link pass `{ messageId }` or `{ conversationId }` on a signed-in key with `chat:read`: the link is fetched only when it is in the named message and a person wrote that message, or the caller wrote it in that conversation, else `refused: 'ai_link'`. A source with no id rejects (`ValidationError`). Not in encrypted chats: the server cannot read them, so leave `source` out there and apply the app's own rule |
-| `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?, replies?: 'none' })` (`replies: 'none'`, 0.7.78: the post alone for a card, with `repliesStatus: 'not_requested'`; `getPublicConversation` and `getConnectedSocialConversation` take it too). 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`; a Fediverse community's newest threads, read-only (0.7.109): `getOpenGroupThreads({ group, limit?, cursor?, compass? })`, `group` being the `actor` of a groups read's `open_network` entry; 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; a story a World Today story seeded carries `volume`, the first page of the posts that story counts across Minds and the open networks, whose `cursor` goes on with `curator.storyPosts` or `curator.memberStoryPosts`), 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` |
+| `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?, replies?: 'none' })` (`replies: 'none'`, 0.7.78: the post alone for a card, with `repliesStatus: 'not_requested'`; `getPublicConversation` and `getConnectedSocialConversation` take it too). 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`; a Fediverse community's newest threads, read-only (0.7.109): `getOpenGroupThreads({ group, limit?, cursor?, compass? })`, `group` being the `actor` of a groups read's `open_network` entry; 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; a story a World Today story seeded carries `volume`, the first page of the posts that story counts across Minds and the open networks, whose `cursor` goes on with `curator.storyPosts` or `curator.memberStoryPosts`), 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); keyless category surface (0.7.165): `getSharedCategorySurface(projectId, { category, compass? })`, a category's `stories`, `network` and `clips` for a signed-out page in one read under every visitor floor (`compass` `all` or `hide`, or a side or Mix where the visitor catalog lists `compass_sides`, answered `unavailable`; never people or groups); 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/`.
 
@@ -657,8 +658,67 @@ for (const network of data.networks) {
 await r.protocols.setNetwork('nostr', { enabled: false, removePast: true });
 ```
 
+One-tap actions act as the member's own identity on that network by default (0.7.191). `engageLike`,
+`engageRepost`, `engageFollow`, `engageReply` and `engageQuote` take `identity?: 'native' | 'linked'`. A
+native answer is sent (`queued: false`, with the network's `delivery`) or, while the identity is still
+being set up, queued (202, `queued: true`, sent in order once it is on; `pendingInteractions()` lists
+them). A linked answer is the review to submit, as `prepareNativeLike` always returned. Every answer
+says who acted (`actedAs`). A member who linked an account before the cutover keeps acting as it until they
+choose otherwise with `setEngageDefault(network, 'native')`; the first such answer carries
+`notice: 'engage_default_linked'`. An account linked later is a choice: `setEngageDefault(network, 'linked')`.
+Keep the same `clientMutationId` across retries: a retry is answered from the first tap, never sent twice
+(once that tap expired unsent, with `delivery.code` `interaction_expired`; a new tap takes a new id). A native
+reply's or quote's `media` takes only the member's own Minds uploads, as the linked flows do.
+
+```ts
+const { data } = await r.protocols.engageLike({ protocol: 'bluesky', nativeId: post.nativeId, clientMutationId, action: 'like' });
+if (data.identity === 'native') showActedAs(data.actedAs, data.queued ? 'Sending when your account is ready' : null);
+else await r.protocols.submitNativeLike(data.id, { approve: true });
+```
+
+A member's AT Protocol account is created on the PDS Minds runs, with their verified email (0.7.191); Minds keeps only a
+revocable app password named "Minds". `claimAtprotoPassword({ password })` (or `{ emailCode }` from
+`POST /settings/confirmation-code` with purpose `atproto_password`, for an account with no password) has the PDS
+email a reset code to that address, so the member can sign in from any AT Protocol app and revoke Minds there.
+A member without a verified email reads `needs_action` with reason `needs_verified_email` on AT Protocol.
+
+```ts
+const { data } = await r.protocols.claimAtprotoPassword({ password });
+show(`We sent a reset code for ${data.handle} to ${data.sentTo}`);
+```
+
+AT Protocol reads `needs_action` with reason `needs_atproto_grant` for an account made before Minds ran it natively,
+and `error` with `app_password_revoked` after the member revoked Minds' app password. `grantAtproto({ password })`
+(0.7.191), with that account's password (or a non-privileged app password the member made), lets Minds act as it again:
+Minds keeps only a new revocable app password, and answers the handle and the presence after the grant.
+
+```ts
+const { data } = await r.protocols.grantAtproto({ password: atPassword });
+if (data.presence.state === 'on') show(`Minds acts as ${data.handle} again`);
+```
+
+A member can take their Minds-held Nostr key home, in three steps of their own:
+`protocols.exportNostrKey({ password })` returns it as an `nsec` (an account with no password
+sends `{ emailCode }` from `settings.requestConfirmationCode('nostr_key')`); after they
+import it into their signer, `nostrRebindChallenge()` and `rebindNostrKey(signedEvent)`
+prove the device holds the same key; then `deleteManagedNostrCopy({ password })` deletes
+Minds' copy, and every later Nostr action is signed on their device. What Minds published
+with the key still comes down when they delete a post or their account (Minds signs those
+takedowns before the copy goes; 409 `too_many_published` keeps the copy when there is too
+much). Show the `nsec` to the member alone and never log it. None of these is retried
+automatically.
+
 ### Native Nostr signing
 
+A member's Nostr key is either their own, signed on their device, or one Minds holds for them (0.7.192).
+`nativeNostrAccount()` says which: `signing: 'client'` is the flow below; `signing: 'server'` (with
+`mode: 'managed'`) means Minds signs. Then `prepareNativeNostr` is the preview to show (nothing is signed
+or sent), and `prepareNativeNostr(id, { ...input, send: true })` once the member approves signs and sends
+in that call and answers with the `receipt` (nothing to submit). A like, repost or follow review is submitted with
+`{ approve: true }` and no `event`, and `engageLike`, `engageReply`, `engageFollow` and the rest with
+`identity: 'native'` act as that key in one tap. For a key Minds holds, a like or repost Minds is still sending (the
+relay has not taken it yet) reads as liked or reposted with `acknowledged: false`, and an unlike or unrepost removes it.
+
 Use `protocols.nativeNostrAccount()` to check the app's explicit native-write
 capability. For an enabled connected key, prepare a text post with
 `prepareNativeNostr(identityId, { action: 'publish', content })`, show its
@@ -959,6 +1019,16 @@ is a visitor's top (safe items only, the same for every visitor in one 15-minute
 read with no credential so the edge can hold it. Each answers 404 while the app's operator
 has it off. Send `block: 'top'` and the item's position with a visible view of a top item.
 
+`sdk.feeds.firehose({ session, limit?, compass?, network? })` (0.7.195) is the member's live
+stream: the next items of the most engaged, viral and breaking posts of Minds and the open
+networks, re-checked for the member on the server and never sent twice in one `session`. Each
+item carries `network`, `state` (`breaking`, `viral` or null), `publishedAt`, `chosenAt`, an
+in-app `target` and, for an open-network post, a `card`. Reveal them one at a time and read
+again no sooner than `meta.refillAfterMs`; remove the refs in `retract` wherever you hold them.
+404 while the app's operator has it off; 429 and 503 carry Retry-After. A Mix or Choose sides `compass`
+spends one of the member's hourly sided Politics reads at most once per `session` and choice in ten
+minutes, and answers 429 `compass_rate_limited` once those are spent.
+
 A feed session opens with it when asked: `createFeed({ networks, top: { ref, session? }, seen,
 seenClusters?, bucket? })` (or `new DiscoveryFeedSession(..., { top: { ref, read, post? }, seen })`
 with your own readers). The top's read starts with the first page's reads, and the top holds

package/dist/index.d.ts

@@ -68,6 +68,7 @@ import { LinkPreviewResource } from './resources/link-preview.js';
 import { SearchResource } from './resources/search.js';
 import { BookmarksResource } from './resources/bookmarks.js';
 import { FeedsResource } from './resources/feeds.js';
+import { AliveResource } from './resources/alive.js';
 import { AccountsResource } from './resources/accounts.js';
 import { SignalsResource } from './resources/signals.js';
 import { SealedResource } from './resources/sealed.js';
@@ -133,6 +134,8 @@ export declare class Recursiv {
     readonly discovery: DiscoveryResource;
     /** The top of a feed: what the member (or a visitor) is most likely to engage with, rotated by what they have seen. */
     readonly feeds: FeedsResource;
+    /** The alive tick: whether people the member follows posted, current counts on screen, new replies (0.7.193). */
+    readonly alive: AliveResource;
     readonly video: VideoResource;
     readonly appSubscriptions: AppSubscriptionsResource;
     readonly boosts: BoostsResource;
@@ -182,7 +185,7 @@ export type { E2eeAccountReset, E2eeDevice, E2eeDevicesRealtimeEvent, E2eeEnvelo
 export { ProjectsResource } from './resources/projects.js';
 export { AgentsResource, SUPPORTED_MODELS, AGENT_DIRECTORY_SORTS, AGENT_DIRECTORY_MAX_LIMIT } 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 { EvidenceTarget, EvalType, CreateEvalInput, SimulateInput, SimulateResult, EvalRunRow, EvalResultRow, EvalRunDetail, EvidenceSummary, EvidenceEvent, EvidenceRecordDetail, CreateEvalSetInput, EvalSetRow, EvalRunExport } from './resources/evidence.js';
 export type { AgentMessage, AgentMessageInput, AgentInboxParams, AgentAskInput, AgentAskResult, SupportedModel, SalesLead, SalesLeadListParams, SalesLeadStatus, AgentDirectorySort, AgentDirectoryParams, AgentDirectoryEntry, AgentDirectoryMeta, AgentDirectoryPage } from './resources/agents.js';
 export { TagsResource } from './resources/tags.js';
 export { SandboxResource } from './resources/sandbox.js';
@@ -205,7 +208,7 @@ export { EnvVarsResource } from './resources/env-vars.js';
 export type { QueryDatabaseInput, QueryResult } from './resources/databases.js';
 export { GitHubResource } from './resources/github.js';
 export { DeploymentsResource } from './resources/deployments.js';
-export type { DeploymentReleaseInput, DeploymentRelease, DeploymentReleaseOperation, DeploymentReleaseRecoveryInput } from './resources/deployments.js';
+export type { DeploymentReleaseInput, DeploymentReleaseReservationInput, DeploymentRelease, DeploymentReleaseOperation, DeploymentReleaseRecoveryInput } from './resources/deployments.js';
 export type { PrepareProtocolServersInput, PreparedProtocolServers, ProtocolServerPreparation, ProtocolServerUpgradePreview, ProtocolServerUpgradeInput, ProtocolServerUpgradeStatus } from './resources/deployments.js';
 export { IntegrationsResource } from './resources/integrations.js';
 export type { ExecuteToolInput, ExecuteToolResult } from './resources/integrations.js';
@@ -229,10 +232,12 @@ export { TrustResource } from './resources/trust.js';
 export type { TrustEnvelope, OwnTrustEvent, TrustPublicKey, OwnTrustEvents } from './resources/trust.js';
 export { LinkPreviewResource } from './resources/link-preview.js';
 export { SEARCH_MEDIA_KINDS, SEARCH_SECTIONS, SearchResource } from './resources/search.js';
-export type { PublicSearchPage, PublicSearchTab, SearchAnswer, SearchGroup, SearchLadder, SearchOmitReason, SearchParams, SearchPerson, SearchPost, SearchRelated, SearchResponse, SearchSection, SearchStage, SearchStory, SearchTopic, SearchVia, SearchMedia, SearchMediaEmbed, SearchMediaItem, SearchMediaKind, SearchMediaProvider, SearchMediaProviderStatus, SearchMediaSource, } from './resources/search.js';
+export type { PublicSearchPage, PublicSearchTab, SearchAnswer, SearchGroup, SearchLadder, SearchOmitReason, SearchParams, SearchPerson, SearchPicture, SearchPost, SearchRelated, SearchResponse, SearchSection, SearchStage, SearchStory, SearchTopic, SearchVia, SearchVideoLeadEntry, SearchVideoLeadSource, SearchMedia, SearchMediaEmbed, SearchMediaItem, SearchMediaKind, SearchMediaProvider, SearchMediaProviderStatus, SearchMediaSource, } from './resources/search.js';
 export { BOOKMARK_MERGE_MAX_ITEMS, BookmarkCollectionsResource, BookmarksResource } from './resources/bookmarks.js';
 export { FEED_TOP_NETWORKS, FeedsResource } from './resources/feeds.js';
-export type { FeedStoriesParams, FeedStoriesResponse, FeedStory, FeedTopExplain, FeedTopItem, FeedTopMeta, FeedTopNetwork, FeedTopNetworkCard, FeedTopNetworkEntry, FeedTopNetworkMap, FeedTopParams, FeedTopResponse, FeedTopTarget, PublicFeedTopMeta, PublicFeedTopParams, PublicFeedTopResponse, } from './resources/feeds.js';
+export { AliveResource } from './resources/alive.js';
+export type { AliveTick, AliveTickCounts, AliveTickParams } from './resources/alive.js';
+export type { FeedFirehoseItem, FeedFirehoseMeta, FeedFirehoseNetwork, FeedFirehoseParams, FeedFirehoseResponse, FeedStoriesParams, FeedStoriesResponse, FeedStory, FeedTopExplain, FeedTopItem, FeedTopMeta, FeedTopNetwork, FeedTopNetworkCard, FeedTopNetworkEntry, FeedTopNetworkMap, FeedTopParams, FeedTopResponse, FeedTopTarget, PublicFeedTopMeta, PublicFeedTopParams, PublicFeedTopResponse, } from './resources/feeds.js';
 export type { BookmarkCollection, BookmarkCollectionInput, BookmarkCollectionKind, BookmarkCollectionPatch, BookmarkCollectionsList, BookmarkCollectionTarget, BookmarkCollectionVisibility, BookmarkedPost, BookmarkInput, BookmarkItem, BookmarkKey, BookmarkKeyRow, BookmarkKeysPage, BookmarkKind, BookmarkMergeItem, BookmarkMergeResult, BookmarkProtocol, BookmarkRequestOptions, BookmarksPage, FiledBookmark, RemovedBookmarkCollection, SavedBookmark, UnfiledBookmark, UnsavedBookmark, } from './resources/bookmarks.js';
 export { AccountsResource } from './resources/accounts.js';
 export { SIGNAL_BATCH_MAX, SignalsResource, newClientEventId } from './resources/signals.js';
@@ -249,11 +254,11 @@ export { UploadsResource } from './resources/uploads.js';
 export type { UploadMediaInput, UploadUrlInput, UploadUrlResult } from './resources/uploads.js';
 export { WalletResource } from './resources/wallet.js';
 export type { LinkedTokenWallet, PayoutState, TokenBalance, TokenLedgerEntry, WalletLink, WalletLinkNonce } from './resources/wallet.js';
-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 { BoostsResource, spliceBoostSlots } from './resources/boosts.js';
+export type { BoostBalance, BoostBalanceResponse, BoostCampaign, BoostCampaignResponse, BoostCampaignStats, BoostDailyStats, BoostEventResult, BoostLedgerEntry, BoostLedgerKind, BoostPlanCredit, BoostRejectionReason, BoostReviewStatus, BoostSlotItem, BoostSlotSurface, BoostSlotsParams, BoostSlotsResponse, BoostStatus, BoostTopupCheckout, BoostTopupConfirmation, BoostTopupLimits, BoostTokenTopupInfo, BoostTokenTopupResult, PublicBoostSlotsParams, } from './resources/boosts.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, SOCIAL_FOLLOWING_SOURCE_STATUSES, viralItemHasVideo, } from './resources/protocols.js';
-export type { SocialProfile, SocialBridge, SocialMention, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarSourceKind, 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, SocialPopularProfile, SocialPopularProfilesParams, SocialPopularProfilesProtocol, SocialPopularProfilesSource, SocialAuthorFeed, OpenGroupThreads, OpenGroupThreadsGroup, OpenGroupThreadsParams, SocialFollowingFeed, SocialFollowingSource, SocialFollowingSourceStatus, SearchPublicProfilesParams, SearchPublicPostsParams, SocialPostSearch, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeNetwork, NativeNetworkState, NativeNetworkPresence, NativeNetworkActivation, NativeNetworkOff, SetNativeNetworkInput, NativeSocialCallbackInput, NativeReplyPrepareInput, NativePostPrepareInput, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostQuote, 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, ProtocolIngestionActivityReason, ProtocolIngestionCircuitHealth, ProtocolIngestionDeadLetterGroup, ProtocolIngestionHealthPosition, ProtocolIngestionHealthReport, ProtocolIngestionHealthRuntime, ProtocolIngestionHealthSection, ProtocolIngestionLaneActivity, ProtocolIngestionLaneCurrentJob, ProtocolIngestionLaneDeadLetters, ProtocolIngestionLaneHealth, ProtocolIngestionLaneJobs, ProtocolIngestionReplayResult, ProtocolIngestionStatus, ProtocolQuarantinedCandidate, ProtocolRefreshResult, ProtocolSettings, ProtocolSettingsUpdateResult, ReplayProtocolIngestionJobInput, UpdateSettingsInput as UpdateProtocolSettingsInput, } from './resources/protocols.js';
+export type { SocialProfile, SocialBridge, SocialMention, SocialSubscription, SocialSubscriptionChange, SocialProfilePage, SocialRadar, SocialRadarCluster, SocialRadarMember, SocialRadarParams, SocialRadarSourceKind, SocialRadarPosts, SocialRadarStory, SharedCategorySurface, SharedCategorySurfaceParams, 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, SocialPopularProfile, SocialPopularProfilesParams, SocialPopularProfilesProtocol, SocialPopularProfilesSource, SocialAuthorFeed, OpenGroupThreads, OpenGroupThreadsGroup, OpenGroupThreadsParams, SocialFollowingFeed, SocialFollowingSource, SocialFollowingSourceStatus, SearchPublicProfilesParams, SearchPublicPostsParams, SocialPostSearch, HostedProtocolConnections, HostedProtocol, HostedProtocolIdentity, HostedNostrChallenge, HostedNostrIdentityProof, NativeNostrPrepareInput, NativeNostrPrepared, NativeNostrAccount, NativeNostrPostState, NativeNostrReceipt, NativeSocialProtocol, FederationIdentity, FederationIdentityView, NativeSocialAccount, NativeNetwork, NativeNetworkState, NativeNetworkPresence, NativeNetworkActivation, NativeNetworkOff, SetNativeNetworkInput, AtprotoPasswordClaimProof, AtprotoPasswordClaim, AtprotoGrant, EngageIdentity, EngageActedAs, EngageLinkedFields, NativeEngageSent, NativeEngageQueued, EngageAnswer, PendingNativeInteraction, EngageOneInput, NostrKeyStepUp, ManagedNostrKeyExport, NostrRebindChallenge, NostrRebindResult, ManagedNostrCopyDeleted, NativeSocialCallbackInput, NativeReplyPrepareInput, NativePostPrepareInput, NativeMediaInput, NativeMediaItem, NativePostBatch, NativePostQuote, 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, ProtocolIngestionActivityReason, ProtocolIngestionCircuitHealth, ProtocolIngestionDeadLetterGroup, ProtocolIngestionHealthPosition, ProtocolIngestionHealthReport, ProtocolIngestionHealthRuntime, ProtocolIngestionHealthSection, ProtocolIngestionLaneActivity, ProtocolIngestionLaneCurrentJob, ProtocolIngestionLaneDeadLetters, ProtocolIngestionLaneHealth, ProtocolIngestionLaneJobs, 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/index.js

@@ -69,6 +69,7 @@ import { LinkPreviewResource } from './resources/link-preview.js';
 import { SearchResource } from './resources/search.js';
 import { BookmarksResource } from './resources/bookmarks.js';
 import { FeedsResource } from './resources/feeds.js';
+import { AliveResource } from './resources/alive.js';
 import { AccountsResource } from './resources/accounts.js';
 import { SignalsResource } from './resources/signals.js';
 import { SealedResource } from './resources/sealed.js';
@@ -134,6 +135,8 @@ export class Recursiv {
     discovery;
     /** The top of a feed: what the member (or a visitor) is most likely to engage with, rotated by what they have seen. */
     feeds;
+    /** The alive tick: whether people the member follows posted, current counts on screen, new replies (0.7.193). */
+    alive;
     video;
     appSubscriptions;
     boosts;
@@ -212,6 +215,7 @@ export class Recursiv {
         this.jobs = new JobsResource(client);
         this.curator = new CuratorResource(client);
         this.feeds = new FeedsResource(client);
+        this.alive = new AliveResource(client);
         this.discovery = new DiscoveryResource(this.posts, this.protocols, this.curator, client, this.feeds);
         this.video = new VideoResource(client);
         this.appSubscriptions = new AppSubscriptionsResource(client);
@@ -287,6 +291,7 @@ export { LinkPreviewResource } from './resources/link-preview.js';
 export { SEARCH_MEDIA_KINDS, SEARCH_SECTIONS, SearchResource } from './resources/search.js';
 export { BOOKMARK_MERGE_MAX_ITEMS, BookmarkCollectionsResource, BookmarksResource } from './resources/bookmarks.js';
 export { FEED_TOP_NETWORKS, FeedsResource } from './resources/feeds.js';
+export { AliveResource } from './resources/alive.js';
 export { AccountsResource } from './resources/accounts.js';
 export { SIGNAL_BATCH_MAX, SignalsResource, newClientEventId } from './resources/signals.js';
 export { SEALED_ALLOWANCE_REMAINING_HEADER, SEALED_REFUSAL_HEADER, SealedResource, SealedTransportError, SEALED_WEB_OFF, isSealedWebOff, } from './resources/sealed.js';
@@ -295,7 +300,7 @@ export { ProjectSettingsResource } from './resources/project-settings.js';
 export { OrganizationSecurityResource } from './resources/organization-security.js';
 export { UploadsResource } from './resources/uploads.js';
 export { WalletResource } from './resources/wallet.js';
-export { BoostsResource } from './resources/boosts.js';
+export { BoostsResource, spliceBoostSlots } from './resources/boosts.js';
 export { ProtocolsResource } from './resources/protocols.js';
 export { PROTOCOL_ADAPTER_MATURITIES, PROTOCOL_CAPABILITY_OPERATIONS, PROTOCOL_CAPABILITY_STATUSES, SOCIAL_FOLLOWING_SOURCE_STATUSES, viralItemHasVideo, } from './resources/protocols.js';
 export { InboxResource } from './resources/inbox.js';

package/dist/resources/alive.d.ts

@@ -0,0 +1,61 @@
+import type { HttpClient } from '../client.js';
+/**
+ * The alive tick (0.7.193): one calm read for the member, with their own key of the app, that says whether anyone they
+ * follow has posted since the newest row they hold, keeps the counts of the posts on their screen current, and counts
+ * the new replies under the post they have open. Off until the operator turns on `ALIVE_TICK_ENABLED`: the read then
+ * throws `NotFoundError` (code `alive_disabled`), and the app stops ticking.
+ *
+ * Tick again after `nextAfterMs` (the server slows every client this way), only while the page is visible. One tick
+ * carries every open screen's interests. A tick is asked once (`retry: false`): the next tick is its retry. More than
+ * 4 a minute for one member throws `RateLimitError`.
+ */
+/** What one tick asks about. Each part is answered only when asked for. */
+export interface AliveTickParams {
+    /** The newest row the member holds on Following (a Date or an ISO 8601 instant). */
+    followingSince?: Date | string;
+    /** Ids of the Minds posts on screen, at most 30 (more is refused). */
+    posts?: readonly string[];
+    /** The open post's id and the newest reply the member holds under it (or when the thread was loaded). */
+    thread?: {
+        id: string;
+        since: Date | string;
+    };
+}
+/** A post's numbers, as its card shows them. */
+export interface AliveTickCounts {
+    score: number;
+    upvote_count: number;
+    reply_count: number;
+    reposts_count: number;
+}
+export interface AliveTick {
+    /**
+     * Whether anyone the member follows posted a top-level Minds post after `followingSince` that they may be served
+     * (their blocks, mutes and safety setting applied), and when the newest of them was written. Load the new rows behind
+     * the new-posts pill; never move what the member is reading.
+     */
+    following?: {
+        fresh: boolean;
+        newestAt: string | null;
+    };
+    /**
+     * The current numbers of the posts asked for that the member may be served, by post id. A post left out (a repost,
+     * a reply, one the member may not be served) keeps the number the app has.
+     */
+    counts?: Record<string, AliveTickCounts>;
+    /** How many replies under the open post the member may see were written after `thread.since`, their own left out. */
+    thread?: {
+        newReplies: number;
+        newestAt: string | null;
+    };
+    /** When to tick next, in milliseconds. */
+    nextAfterMs: number;
+    /** When the server read it. */
+    asOf: string;
+}
+export declare class AliveResource {
+    private client;
+    constructor(client: HttpClient);
+    /** One tick for the member (GET /alive/tick, `users:read`, their own key of the app). */
+    tick(params?: AliveTickParams): Promise<AliveTick>;
+}

package/dist/resources/alive.js

@@ -0,0 +1,16 @@
+const iso = (value) => (value instanceof Date ? value.toISOString() : value);
+export class AliveResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** One tick for the member (GET /alive/tick, `users:read`, their own key of the app). */
+    tick(params = {}) {
+        return this.client.get('/alive/tick', {
+            following_since: params.followingSince === undefined ? undefined : iso(params.followingSince),
+            posts: params.posts?.length ? params.posts.join(',') : undefined,
+            thread: params.thread?.id,
+            thread_since: params.thread ? iso(params.thread.since) : undefined,
+        }, { retry: false });
+    }
+}

package/dist/resources/boosts.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { PaginatedResponse, SingleResponse } from '../types.js';
+import type { PaginatedResponse, Post, SingleResponse } from '../types.js';
 /** Campaign lifecycle axis. */
 export type BoostStatus = 'active' | 'paused' | 'completed' | 'refunded';
 /** Campaign moderation axis. A campaign delivers only when `active` AND `approved`. */
@@ -59,12 +59,30 @@ export interface BoostPlanCredit {
      */
     owed_micros?: number;
 }
+/** Paying for Boost with tokens. */
+export interface BoostTokenTopupInfo {
+    /** False until the platform sets the price of a token. */
+    available: boolean;
+    /** Micro-USD of Boost balance one token buys; null when unavailable. */
+    usd_micros_per_token: number | null;
+    /** Most whole tokens one conversion takes. */
+    max_tokens: number;
+}
+export interface BoostTokenTopupResult {
+    /** False when this request_id was already credited: nothing new was written. */
+    applied: boolean;
+    tokens: number;
+    credited_micros: number;
+    balance_micros: number;
+}
 export interface BoostBalanceResponse extends SingleResponse<BoostBalance> {
     /** `plan_credit` is null when the app's plans include no boost credit (absent from older servers). */
     meta: {
         min_cpm_micros: number;
         topup?: BoostTopupLimits;
         plan_credit?: BoostPlanCredit | null;
+        /** Absent from older servers. */
+        token_topup?: BoostTokenTopupInfo;
     };
 }
 export interface BoostCampaignResponse extends SingleResponse<BoostCampaign> {
@@ -80,6 +98,27 @@ export interface BoostEventResult {
     spent_micros: number;
     impressions_served: number;
 }
+/** One UTC day of a campaign's results. */
+export interface BoostDailyStats {
+    /** `YYYY-MM-DD`, UTC. */
+    date: string;
+    impressions: number;
+    clicks: number;
+}
+/** What a campaign delivered: totals and a per-day series (days with no events are absent). */
+export interface BoostCampaignStats {
+    campaign: BoostCampaign;
+    totals: {
+        impressions: number;
+        clicks: number;
+        /** clicks / impressions, or null before the first view. */
+        click_rate: number | null;
+        spent_micros: number;
+        /** Spend per 1,000 views in micro-USD, or null before the first view. */
+        cost_per_1000_micros: number | null;
+    };
+    daily: BoostDailyStats[];
+}
 export interface BoostTopupCheckout {
     /** Stripe Checkout URL to open. */
     url: string;
@@ -92,6 +131,47 @@ export interface BoostTopupConfirmation {
     credited_micros: number;
     balance_micros: number | null;
 }
+/** A feed whose boosts the app splices into its pages itself: All, a category, or the big-screen grid of either. */
+export type BoostSlotSurface = 'all' | 'category' | 'grid';
+export interface BoostSlotsParams {
+    surface: BoostSlotSurface;
+    /** A browse category id: required for `category`, allowed for `grid`, refused for `all`. */
+    category?: string;
+    /** How many posts the page has before its boosts (1..50, default 20). */
+    limit?: number;
+    /** Up to 50 post ids already on the page (and the originals they carry): never served as a boost. */
+    exclude?: readonly string[];
+    /** The Politics choice the page is served under: under one that leaves posts out, only boosts judged not political. */
+    compass?: string;
+}
+export interface PublicBoostSlotsParams extends BoostSlotsParams {
+    /** The public app whose feed it is. */
+    projectId: string;
+}
+/** One boost of a page: where it stands in the page as served, and the boosted post (labelled `boosted: true`). */
+export interface BoostSlotItem {
+    place: number;
+    post: Post;
+}
+export interface BoostSlotsResponse {
+    data: BoostSlotItem[];
+    meta: {
+        surface: BoostSlotSurface;
+        category: string | null;
+        limit: number;
+        /** One boost per `every` posts. */
+        every: number;
+        /** No boost before this place (0-based): the first two places are never a boost. */
+        first: number;
+        /** Why there are none: the key is bound to no app, or (a visitor's read) the app is not public. */
+        reason?: 'no_app' | 'not_public';
+    };
+}
+/**
+ * A page with its boosts in their places: each slot's post goes in at its `place`, in order, and one whose place the
+ * page does not reach is left out, so a short page never pulls a boost forward. The page's own posts keep their order.
+ */
+export declare function spliceBoostSlots<T>(page: readonly T[], slots: readonly BoostSlotItem[]): Array<T | Post>;
 /**
  * Boost: pay to promote your own post into the For You feed. CPM campaigns
  * funded from a prepaid balance with an append-only ledger. Top-ups run on the
@@ -126,6 +206,35 @@ export declare class BoostsResource {
     resume(campaignId: string): Promise<BoostCampaignResponse>;
     /** Cancel a campaign and refund its unspent budget to your balance (`meta.refunded_micros`). */
     cancel(campaignId: string): Promise<BoostCampaignResponse>;
+    /**
+     * One page's boosts for a feed the app splices them into itself (All, a category, or the big-screen grid), read beside
+     * the page: pass the page's own post count as `limit` and its post ids as `exclude`, then put each item's post in at
+     * its `place` (`spliceBoostSlots`). Each post is labelled `boosted: true` with `boost_campaign_id` and
+     * `boost_disclosure`; report what was seen with `recordEvent`. Never the member's own campaign, one they hid or one
+     * walled from them. Watch's boosts come on its own pages.
+     */
+    slots(params: BoostSlotsParams, options?: {
+        retry?: boolean;
+    }): Promise<BoostSlotsResponse>;
+    /**
+     * A visitor's boosts for one page of a public app's feed (tRPC `publicDiscovery.boostSlots`), as `slots` answers a
+     * member: read with no credential at all (no key, no cookie: `credentials: 'omit'`). An app that is not public answers
+     * none (`meta.reason` `not_public`).
+     */
+    publicSlots(params: PublicBoostSlotsParams, options?: {
+        timeoutMs?: number;
+    }): Promise<BoostSlotsResponse>;
+    /** Results for one of your campaigns: views, clicks, click rate, spend and a daily series. */
+    stats(campaignId: string): Promise<SingleResponse<BoostCampaignStats>>;
+    /**
+     * Turn whole tokens into Boost balance at the platform's price (`balance().meta.token_topup`).
+     * `request_id` (8 to 100 of A-Z a-z 0-9 - _) makes a retry safe: the same id debits once.
+     * Not retried automatically.
+     */
+    topupWithTokens(input: {
+        tokens: number;
+        request_id: string;
+    }): Promise<SingleResponse<BoostTokenTopupResult>>;
     /** Report an impression or click on a boosted feed entry. Idempotent per viewer per UTC day. */
     recordEvent(campaignId: string, kind: 'impression' | 'click'): Promise<SingleResponse<BoostEventResult>>;
     /**

package/dist/resources/boosts.js

@@ -1,3 +1,17 @@
+import { NotFoundError, RecursivError } from '../errors.js';
+/**
+ * A page with its boosts in their places: each slot's post goes in at its `place`, in order, and one whose place the
+ * page does not reach is left out, so a short page never pulls a boost forward. The page's own posts keep their order.
+ */
+export function spliceBoostSlots(page, slots) {
+    const out = [...page];
+    for (const slot of [...slots].sort((a, b) => a.place - b.place)) {
+        if (!Number.isInteger(slot.place) || slot.place < 0 || slot.place > out.length)
+            continue;
+        out.splice(slot.place, 0, slot.post);
+    }
+    return out;
+}
 /**
  * Boost: pay to promote your own post into the For You feed. CPM campaigns
  * funded from a prepaid balance with an append-only ledger. Top-ups run on the
@@ -39,6 +53,72 @@ export class BoostsResource {
     cancel(campaignId) {
         return this.client.post(`/boosts/${encodeURIComponent(campaignId)}/cancel`, {});
     }
+    /**
+     * One page's boosts for a feed the app splices them into itself (All, a category, or the big-screen grid), read beside
+     * the page: pass the page's own post count as `limit` and its post ids as `exclude`, then put each item's post in at
+     * its `place` (`spliceBoostSlots`). Each post is labelled `boosted: true` with `boost_campaign_id` and
+     * `boost_disclosure`; report what was seen with `recordEvent`. Never the member's own campaign, one they hid or one
+     * walled from them. Watch's boosts come on its own pages.
+     */
+    slots(params, options) {
+        return this.client.get('/boosts/slots', {
+            surface: params.surface, category: params.category, limit: params.limit,
+            exclude: params.exclude?.length ? params.exclude.join(',') : undefined, compass: params.compass,
+        }, options);
+    }
+    /**
+     * A visitor's boosts for one page of a public app's feed (tRPC `publicDiscovery.boostSlots`), as `slots` answers a
+     * member: read with no credential at all (no key, no cookie: `credentials: 'omit'`). An app that is not public answers
+     * none (`meta.reason` `not_public`).
+     */
+    async publicSlots(params, options) {
+        const input = { projectId: params.projectId, surface: params.surface, ...(params.category ? { category: params.category } : {}),
+            ...(params.limit !== undefined ? { limit: params.limit } : {}), ...(params.exclude?.length ? { exclude: [...params.exclude] } : {}),
+            ...(params.compass ? { compass: params.compass } : {}) };
+        const url = `${this.client.baseOrigin}/api/trpc/publicDiscovery.boostSlots?input=${encodeURIComponent(JSON.stringify(input))}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), options?.timeoutMs ?? this.client.requestTimeoutMs);
+        try {
+            let response;
+            try {
+                response = await fetch(url, { method: 'GET', headers: { Accept: 'application/json' }, credentials: 'omit', signal: controller.signal });
+            }
+            catch (error) {
+                throw new RecursivError(0, { type: 'api_error', code: controller.signal.aborted ? 'timeout' : 'network_error',
+                    message: controller.signal.aborted ? 'The visitor boost slots did not answer in time.' : `The visitor boost slots could not be reached (${error instanceof Error ? error.message : String(error)}).` });
+            }
+            let body = null;
+            try {
+                body = await response.json();
+            }
+            catch {
+                body = null;
+            }
+            const data = body?.result?.data;
+            if (response.ok && data && typeof data === 'object')
+                return data;
+            const error = body?.error && typeof body.error === 'object' ? body.error : undefined;
+            const said = [error?.json?.message, error?.message].find((value) => typeof value === 'string' && value.length > 0);
+            const code = typeof error?.data?.code === 'string' ? error.data.code.toLowerCase() : 'unknown_error';
+            const failure = { type: response.status === 404 ? 'not_found_error' : 'api_error', code, message: said ?? `HTTP ${response.status}` };
+            throw response.status === 404 ? new NotFoundError(failure) : new RecursivError(response.ok ? 502 : response.status, failure);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Results for one of your campaigns: views, clicks, click rate, spend and a daily series. */
+    stats(campaignId) {
+        return this.client.get(`/boosts/${encodeURIComponent(campaignId)}/stats`);
+    }
+    /**
+     * Turn whole tokens into Boost balance at the platform's price (`balance().meta.token_topup`).
+     * `request_id` (8 to 100 of A-Z a-z 0-9 - _) makes a retry safe: the same id debits once.
+     * Not retried automatically.
+     */
+    topupWithTokens(input) {
+        return this.client.post('/boosts/topup/tokens', input, { retry: false });
+    }
     /** Report an impression or click on a boosted feed entry. Idempotent per viewer per UTC day. */
     recordEvent(campaignId, kind) {
         return this.client.post(`/boosts/${encodeURIComponent(campaignId)}/events`, { kind });

package/dist/resources/deployments.d.ts

@@ -43,6 +43,10 @@ export interface DeploymentReleaseInput {
     run_id: number;
     attempt: number;
 }
+export interface DeploymentReleaseReservationInput extends DeploymentReleaseInput {
+    /** Optional initial-run GitHub OIDC proof. Requires compatible server support; never log it or retry a refused proof. */
+    coordinator_identity_token?: string;
+}
 export interface DeploymentRelease {
     deployment_id: string;
     status: string;
@@ -183,7 +187,7 @@ export declare class DeploymentsResource {
     private client;
     constructor(client: HttpClient);
     /** Atomically block competing production deployments before promoting the API. Retry explicitly with the SAME capability. */
-    reserveRelease(input: DeploymentReleaseInput): Promise<SingleResponse<DeploymentRelease>>;
+    reserveRelease(input: DeploymentReleaseReservationInput): Promise<SingleResponse<DeploymentRelease>>;
     getRelease(deploymentId: string, projectId: string): Promise<SingleResponse<DeploymentRelease>>;
     /** Mark immediately before API mutation, then only after the existing API health gates pass. */
     advanceRelease(deploymentId: string, input: DeploymentReleaseOperation & {

package/dist/resources/discovery.d.ts

@@ -175,8 +175,11 @@ export interface CategorySurfaceSection<T> {
     ms: number;
     reason?: string;
 }
-/** A radar cluster themed into the category, with up to six members (headline or excerpt and link only). */
-export type CategoryStory = Pick<SocialRadar['clusters'][number], 'id' | 'label' | 'kind' | 'theme' | 'sources' | 'corroboration' | 'laneMix' | 'outlets' | 'velocity' | 'media' | 'freshness' | 'score' | 'members'>;
+/**
+ * A radar cluster themed into the category, with up to six members (headline or excerpt and link only). `political`
+ * (0.7.165) is the radar's own mark, what Hide politics reads; absent from an older server or a copy cached before it.
+ */
+export type CategoryStory = Pick<SocialRadar['clusters'][number], 'id' | 'label' | 'kind' | 'theme' | 'political' | 'sources' | 'corroboration' | 'laneMix' | 'outlets' | 'velocity' | 'media' | 'freshness' | 'score' | 'members'>;
 export interface CategoryClip {
     id: string;
     title: string | null;