@domino-sdk/relay 1.61.0 → 1.63.0

package/dist/action-9Xl0StBg.d.ts

@@ -0,0 +1,33 @@
+import { R as RequestError } from './request-error-D_dUPLwo.js';
+
+/** SDK input convenience; the wire request always carries a key. */
+type OptionalActionId<T> = T extends {
+    actionId: string;
+} ? Omit<T, "actionId"> & {
+    actionId?: string;
+} : never;
+/** One logical write. Keep this object until its outcome is definite. */
+type RelayAction<T> = {
+    /** The pending write's key, also available on its uncertain error as `operationId`. */
+    readonly actionId: string | undefined;
+    readonly busy: boolean;
+    readonly error: RequestError | undefined;
+    /**
+     * Starts a write with a generated key. While an uncertain write is pending, replays its saved
+     * callback instead of accepting a different write. Concurrent calls share one request.
+     * Put refreshes and other follow-up work outside the callback.
+     */
+    run(task: (actionId: string) => Promise<T>): Promise<T>;
+    /** Replays the exact pending callback and key, only when the error's recovery is `replay`. */
+    retry(): Promise<T>;
+    /** Acknowledge an authoritative, definite outcome after reconciliation. Refuses while busy. */
+    settle(): boolean;
+};
+/**
+ * Owns a mutation key across uncertain answers. A definite success or refusal ends the action;
+ * the next `run` gets a new key. `reconcile` failures stay pending and cannot be replayed.
+ * In-memory only: persist the key yourself if recovery must survive a reload or process restart.
+ */
+declare function createRelayAction<T = unknown>(): RelayAction<T>;
+
+export { type OptionalActionId as O, type RelayAction as R, createRelayAction as c };

package/dist/{attempt-captures-DYnJVkfg.d.ts → attempt-captures-DMi8oR9T.d.ts}

@@ -1,4 +1,4 @@
-import { O as OpenIdentityKind } from './schema-CZ6Rj0ZF.js';
+import { O as OpenIdentityKind } from './tracker-data-esm3WG8R.js';
 import * as z from 'zod';
 
 /** One capability call of the captured evaluation run, as Relay stored it. */

package/dist/authoring.d.ts

@@ -1,24 +1,21 @@
-import { B as xContentBodySchema, I as IdentityKind, C as customSourceSchema, W as WithRecordData, D as WithContent, F as WithAccountRoles, y as ResourceHandle, x as QuestHandle, L as LedgerReference, G as GroupHandle, H as pointLedgerDeclarationSchema, J as TrackerSource, N as trackerDefinitionSchema, U as Tracker, V as TrackerData, X as SourceRoles, Y as LedgerHandle, Z as TrackerDataSchema, _ as xSearchSourceSchema, $ as XTweet, a0 as XContentMetric, a1 as TrackerTriggerPolicy, a2 as Where, a3 as MemberIdentity, P as PointBalance, a4 as ReferralHandle, a5 as TrackerTriggerContext, a6 as TrackerReader, a7 as TextReviewInput, a8 as TextResult, z as PhotoResult, a9 as Decision, aa as rewardSchema, ab as TrackerTriggerMode, ac as RoleOf, ad as WhereSetting, ae as ContentBody, af as BadgeHandle, ag as ContentMetricName, ah as triggerSchema, k as QuestPresentation, l as QuestProfile, m as QuizEvidence, ai as TieredRewardDefinition } from './schema-CZ6Rj0ZF.js';
-export { aj as LedgerSetting, ak as TrackerPage, al as TrackerReadQuery, am as trackerDataSchema, an as trackerTriggerContextSchema } from './schema-CZ6Rj0ZF.js';
-import { M as MemberCompletion, B as Budget, A as AuthorBudget } from './capability-error-DufwG3G0.js';
-export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-DufwG3G0.js';
-import { N as NftCollection, o as ContractCall, p as ContractEvent, S as SolanaProgram, q as WalletBalanceSourceQuery, r as WalletTransaction, s as WalletInstruction, e as ProfileReferral, t as WalletReader } from './wallet-CIqFoxdm.js';
-export { u as ContractCallParts, v as ContractCallReturnType, w as ContractEventInput, x as ContractEventParts, y as ContractFunction, z as CosmosDenom, a as CosmosNetwork, E as EvmChainId, B as NftCollectionParts, D as NftStandard, F as WalletBalance, G as WalletBalanceChange, H as WalletBalanceQuery, I as WalletBalanceSample, J as WalletCall, K as WalletCallArgument, M as WalletCallQuery, Q as WalletDelegations, R as WalletDelegationsQuery, T as WalletEventCondition, U as WalletEventValue, V as WalletEvents, X as WalletEventsQuery, Y as WalletNfts, Z as WalletNftsQuery, _ as WalletTransactions, $ as WalletTransactionsQuery, a0 as cosmosDenomSchema, a1 as cosmosNetworkSchema, a2 as isContractCall, a3 as isContractEvent, a4 as isEvmChainId, a5 as isNftCollection, a6 as isSolanaProgram, a7 as maxWalletEventLogs, a8 as maxWalletEventLookback, a9 as maxWalletTransactionLookback, aa as maxWalletTransactions, ab as parseContractCall, ac as parseContractEvent, ad as parseContractFunction, ae as parseNftCollection } from './wallet-CIqFoxdm.js';
+import { _ as EngagementBudget, $ as leaderboardDefinitionSchema, Z as AuthoringIdentity, a0 as pointLedgerDeclarationSchema, a1 as referralAuthoringSchema, a2 as discordMessagesSourceSchema, a3 as DiscordMessageData, a4 as DiscordMessageTextData, a5 as discordReactionsSourceSchema, a6 as DiscordReactionData, a7 as KnownIntegrationModule, P as PointBalance, C as CampaignDefinition, a8 as TextReviewInput, a9 as TextResult, aa as PhotoResult, ab as DiscordReader, ac as Decision, ad as rewardSchema, ae as triggerSchema, af as IntegrationModule, D as QuestPresentation, d as AvailabilityWindow, F as QuestProfile, G as QuizEvidence, W as IntegrationModuleProvider, ag as TieredRewardDefinition } from './accounts-nz3mzfRQ.js';
+export { ah as KnownIntegrationModuleProvider, ai as defineCampaign, aj as defineGroup } from './accounts-nz3mzfRQ.js';
+import { x as xContentBodySchema, I as IdentityKind, j as customSourceSchema, W as WithRecordData, k as WithContent, l as WithAccountRoles, R as ResourceHandle, Q as QuestHandle, L as LedgerReference, G as GroupHandle, m as TrackerSource, n as trackerDefinitionSchema, o as Tracker, p as TrackerData, q as SourceRoles, r as LedgerHandle, i as TrackerDataSchema, u as xSearchSourceSchema, X as XTweet, v as XContentMetric, y as TrackerTriggerPolicy, z as Where, M as MemberIdentity, A as ReferralHandle, B as TrackerTriggerContext, C as TrackerReader, D as TrackerTriggerMode, E as RoleOf, F as WhereSetting, H as ContentBody, J as BadgeHandle, N as ContentMetricName } from './tracker-data-esm3WG8R.js';
+export { P as LedgerSetting, U as TrackerPage, V as TrackerReadQuery, Y as trackerDataSchema, Z as trackerTriggerContextSchema } from './tracker-data-esm3WG8R.js';
+import { R as ResourceSource, M as MemberCompletion, B as Budget, A as AuthorBudget, a as Announcement } from './capability-error-CuI_F7yM.js';
+export { C as CapabilityError, b as CapabilityErrorCode, T as TikTokVideoBody, c as TikTokVideoMetric, Y as YouTubeShortBody, d as YouTubeShortMetric, e as capabilityErrorCodes } from './capability-error-CuI_F7yM.js';
+import { N as NftCollection, p as ContractCall, q as ContractEvent, r as SolanaProgram, s as WalletBalanceSourceQuery, t as WalletTransaction, u as WalletInstruction, e as ProfileReferral, v as WalletReader } from './wallet-B7e06v4m.js';
+export { w as ContractCallParts, x as ContractCallReturnType, y as ContractEventInput, z as ContractEventParts, B as ContractFunction, D as CosmosDenom, a as CosmosNetwork, E as EvmChainId, F as NftCollectionParts, G as NftStandard, H as WalletBalance, I as WalletBalanceChange, o as WalletBalanceQuery, J as WalletBalanceSample, K as WalletCall, M as WalletCallArgument, Q as WalletCallQuery, R as WalletDelegations, T as WalletDelegationsQuery, U as WalletEventCondition, V as WalletEventValue, X as WalletEvents, Y as WalletEventsQuery, Z as WalletNfts, _ as WalletNftsQuery, $ as WalletTransactions, a0 as WalletTransactionsQuery, a1 as cosmosDenomSchema, a2 as cosmosNetworkSchema, a3 as isContractCall, a4 as isContractEvent, a5 as isEvmChainId, a6 as isNftCollection, a7 as isSolanaProgram, a8 as maxWalletEventLogs, a9 as maxWalletEventLookback, aa as maxWalletTransactionLookback, ab as maxWalletTransactions, ac as parseContractCall, ad as parseContractEvent, ae as parseContractFunction, af as parseNftCollection } from './wallet-B7e06v4m.js';
 import * as z from 'zod';
 export { z } from 'zod';
-import { f as badgeDeclarationSchema, B as Badge } from './offers-BoV4ryUc.js';
-export { g as defineOffer } from './offers-BoV4ryUc.js';
-import { E as EngagementBudget, m as leaderboardDefinitionSchema, l as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-CqcA2Ycs.js';
-export { n as defineCampaign, o as defineGroup } from './groups-CqcA2Ycs.js';
-import { d as discordMessagesSourceSchema, D as DiscordMessageData, c as DiscordMessageTextData, e as discordReactionsSourceSchema, f as DiscordReactionData, g as TelegramReader, h as DiscordReader } from './accounts-DoabriBX.js';
-export { i as TelegramChatMember, j as TelegramChatMemberStatus, k as TelegramMessageData, l as TelegramReactionData } from './accounts-DoabriBX.js';
+import { g as badgeDeclarationSchema, h as OfferAuthoring, B as Badge } from './offers-CYeN_I0Y.js';
 import { a as StreakPolicy, Q as QuizContent } from './streaks-0YuipsUQ.js';
-import { R as ResourceSource, S as Setting, A as AmountSetting, B as BalanceChain, a as BoundSettings, b as Announcement } from './announcements-CHx3-HBw.js';
-export { D as DashboardInput, c as DashboardPanelInput, T as TikTokVideoBody, d as TikTokVideoMetric, Y as YouTubeShortBody, e as YouTubeShortMetric, f as defineDashboard } from './announcements-CHx3-HBw.js';
-import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-C54Q8yAD.js';
-export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-C54Q8yAD.js';
-import { I as ImageReader, X as XReader } from './x-D1PGi8Sq.js';
-import { I as IntegrationModule } from './integrations-B3y36OaB.js';
+import { S as Setting, A as AmountSetting, B as BalanceChain, a as BoundSettings } from './dashboards-CLemT6kj.js';
+export { D as DashboardInput, b as DashboardPanelInput, e as defineDashboard } from './dashboards-CLemT6kj.js';
+import { e as TelegramReader, P as Prerequisite, b as TextEvidence, U as UrlEvidence, c as TextOptions, d as UrlOptions } from './submission-input-DZCbjQUH.js';
+export { f as TelegramChatMember, g as TelegramChatMemberStatus, h as TelegramConnection, i as TelegramMessageData, j as TelegramReactionData, k as balanceAtLeast, l as completed, m as inGroup } from './submission-input-DZCbjQUH.js';
+import { I as ImageReader, X as XReader } from './limits-kNzYdZ00.js';
+export { L as Limits, l as limits } from './limits-kNzYdZ00.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
 
 declare function defineBadge(input: z.input<typeof badgeDeclarationSchema>): {
@@ -110,6 +107,64 @@ declare const questCompleted: (quest: QuestHandle) => {
     kind: "quest";
     quest: QuestHandle;
 };
+/**
+ * Define one points-priced offer for a tier reward. The reward title is used when no title is set.
+ * Badge and group rewards throw: only quests grant them.
+ */
+declare function defineOffer(input: OfferAuthoring & AuthoringIdentity): {
+    title: string;
+    enabled: boolean;
+    limit: {
+        perMember: number;
+    };
+    reward: {
+        kind: "tier";
+        reward: {
+            id: string;
+            title: string;
+            tiers: {
+                id: string;
+                title: string;
+            }[];
+            inventory: {
+                kind: "untracked";
+            };
+            fulfillment: {
+                kind: "staff-handover";
+            } | {
+                kind: "automatic";
+            };
+            badge?: string | undefined;
+            group?: string | undefined;
+        };
+        tier: string;
+    };
+    price: {
+        kind: "points";
+        balance: string;
+        amount: number;
+    };
+    stock: number;
+    key: string;
+    requires?: ({
+        kind: "completion";
+        quest: string;
+        scope: "ever";
+    } | {
+        kind: "completion";
+        quest: string;
+        scope: "period";
+        period: "day" | "week" | "month";
+    } | {
+        kind: "balance";
+        balance: string;
+        minimum: number;
+    } | {
+        kind: "group";
+        group: string;
+        title: string;
+    })[] | undefined;
+} & ResourceHandle<"offer">;
 type ReferralInput = z.input<typeof referralAuthoringSchema>;
 type ReferralBonus = NonNullable<ReferralInput["bonuses"]>[number];
 type ReferralMilestone = NonNullable<ReferralInput["milestones"]>[number];
@@ -257,6 +312,20 @@ declare function earned(options?: Omit<EarnedScore, "kind" | "quests"> & {
     kind: "earned";
 };
 type SettlementInput = NonNullable<LeaderboardInput["settle"]>;
+/**
+ * Why `board`'s live standings order equal scores differently from its settlement, or null when
+ * they agree or it has no settlement. `ties` defaults to `"shared"` and is not taken from
+ * `settle.ties`, so a board that sets only `settle.ties: "earliest"` shows shared ranks live and
+ * pays first-to-reach. `defineLeaderboard` and `domino check` warn with it. Exported from `/authoring`, not `/schema`, to keep
+ * the schema entry's browser size down.
+ */
+declare function leaderboardTiesWarning(board: {
+    key?: string;
+    ties?: string;
+    settle?: {
+        ties: string;
+    };
+}): string | null;
 declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" | "balance" | "group" | "score" | "settle"> & AuthoringIdentity & {
     ledger: LedgerReference;
     group?: GroupHandle;
@@ -312,6 +381,7 @@ declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" |
         };
     };
     key: string;
+    ties?: "shared" | "earliest" | undefined;
     includeUnscored?: boolean | undefined;
     settle?: {
         at: "window-end";
@@ -721,12 +791,21 @@ declare const settings: {
         }, z.core.$strict>>;
         correct: z.ZodString;
     }, z.core.$strict>>>>;
+    /**
+     * Free text. With `secret: true`, operators set the value in Console and it never leaves Relay:
+     * management responses, `domino deploy` and Console withhold it, and the quest's code reads it as
+     * usual. A secret setting has no default, so it reads `""` until an operator sets it.
+     */
     text(options: Label & {
-        default: string;
         minLength?: number;
         maxLength?: number;
         multiline?: boolean;
-    }): Setting<"text", z.ZodDefault<z.ZodString>>;
+    } & ({
+        default: string;
+        secret?: false;
+    } | {
+        secret: true;
+    })): Setting<"text", z.ZodDefault<z.ZodString>>;
     /**
      * A Telegram chat the project connected, by its numeric ID: Console lists the connected chats
      * to choose from. Pass it to `ctx.telegram.member({ chat })`.
@@ -840,6 +919,10 @@ declare function invoked(tx: WalletTransaction, program: string): boolean;
  */
 declare function instruction(tx: WalletTransaction, name: string): WalletInstruction["args"] | null;
 
+/**
+ * A reward that awards the member this badge. Quests grant it, and operators by hand; offers,
+ * leaderboard prizes and referral programs throw when given one.
+ */
 declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
     reward: {
         badge: string;
@@ -866,7 +949,8 @@ declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
  * A reward that adds the member to a group when the completion's rewards are delivered. Publishing
  * the quest creates the group, with no members, where it is missing; an archived group refuses.
  * Revoking the completion removes the membership unless an operator's add or another unrevoked
- * completion also backs it.
+ * completion also backs it. Only quests grant it; offers, leaderboard prizes and referral programs
+ * throw when given one.
  */
 declare const groupMembership: (group: GroupHandle) => {
     reward: {
@@ -967,10 +1051,11 @@ type TrackerTriggerInput<T extends Tracker = Tracker, W extends Where<TrackerDat
     /** The tracker handle `defineTracker` returns. */
     tracker: T;
     /**
-     * Which observations fire. `"new-record"`: each record's first observation (the default for X
-     * and Discord trackers, where it means each newly collected post, message or reaction).
-     * `"new-observation"`: each observation that becomes its record's current one (the default for
-     * custom trackers). `"data-changed"`: a
+     * Which observations fire. `"new-record"`: each record's first observation (the default for X,
+     * Discord and Telegram trackers, where it means each newly collected post, message or reaction,
+     * so a removed and re-added Telegram reaction does not fire again). `"new-observation"`: each
+     * observation that becomes its record's current one (the default for other custom trackers,
+     * YouTube and TikTok included, where every refresh observes each video again). `"data-changed"`: a
      * new record, or a current observation whose `data` differs from the previous one.
      */
     on?: TrackerTriggerMode;
@@ -982,10 +1067,11 @@ type TrackerTriggerInput<T extends Tracker = Tracker, W extends Where<TrackerDat
      */
     where?: W;
     /**
-     * The record account whose member the quest pays: `"author"` (the default), `"inReplyTo"` on
-     * an X tracker, `"messageAuthor"` on a Discord reactions tracker, or a named account a custom
-     * source declares in `accounts`. Skipped when that account is the record's author account or
-     * belongs to the author's member, such as a reaction to one's own message.
+     * The record account whose member the quest pays: `"author"` (the default), `"inReplyTo"`,
+     * `"quoted"` or `"reposted"` on an X tracker, `"messageAuthor"` on a Discord reactions tracker,
+     * or a named account a custom source declares in `accounts`. Skipped when that account is the
+     * record's author account or belongs to the author's member, such as a reaction to one's own
+     * message.
      */
     beneficiary?: RoleOf<T>;
     /**
@@ -1126,7 +1212,18 @@ declare const budget: {
     (definition: BudgetDefinition<Budget>): Budget;
     (definition: BudgetDefinition<AuthorBudget>): AuthorBudget;
 };
-declare const keyed: (key: (ctx: KeyedContext) => string) => {
+/** Options of a `keyed(...)` completion. */
+type KeyedOptions = {
+    /**
+     * `"members"`: each key completes the quest once in the whole project and environment, for
+     * whichever member uses it first, such as a single-use code or a post that pays once. Another
+     * member's attempt with a used key is rejected with `key-used`. Without it, each member
+     * completes the quest once per key.
+     */
+    across?: "members";
+};
+declare const keyed: (key: (ctx: KeyedContext) => string, options?: KeyedOptions) => {
+    across?: "members" | undefined;
     kind: "keyed";
     key: (ctx: KeyedContext) => string;
 };
@@ -1136,7 +1233,12 @@ type ProgressDefinition<C> = {
     window?: ReturnType<typeof calendar>;
     repeat?: "once" | "repeat";
 };
-/** Accepted evidence contributes once under its distinct key; Relay commits progress with rewards. */
+/**
+ * A counter completion policy: accepted evidence contributes once under its distinct key, and
+ * the quest completes when `goal` distinct actions fall in the window. Relay commits the count
+ * with rewards. Not evaluator progress (`decision.progress`), which reports how far a member is
+ * toward a target the evaluator measures and never counts toward a counter.
+ */
 declare const progress: (definition: ProgressDefinition<KeyedContext>) => {
     distinct: (ctx: KeyedContext) => string;
     kind: "progress";
@@ -1358,13 +1460,19 @@ type EvaluationCalendar = {
  * the trigger that supplies them and null otherwise. `G` defaults to `any`, which
  * leaves them nullable and lets a shared evaluator, such as `evaluators.photo()`, fit every quest.
  */
-type IntegrationReaders<D extends readonly IntegrationModule[]> = Pick<{
+/**
+ * The declared modules this SDK has readers for. A module it does not know types no reader; an
+ * array typed `IntegrationModule[]`, whose providers are not literals, types every known reader,
+ * as before modules opened.
+ */
+type KnownModules<D extends readonly IntegrationModule[]> = readonly (D[number] extends infer Module extends IntegrationModule ? Module extends KnownIntegrationModule ? Module : string extends Module["provider"] ? KnownIntegrationModule : never : never)[];
+type IntegrationReaders<D extends readonly KnownIntegrationModule[]> = Pick<{
     x: XReader;
     discord: DiscordReader;
 }, D[number]["provider"]>;
 type EvaluationContext<T, I = {
     photo: string;
-}, G = any, D extends readonly IntegrationModule[] = readonly IntegrationModule[]> = {
+}, G = any, D extends readonly KnownIntegrationModule[] = readonly KnownIntegrationModule[]> = {
     settings: T;
     member: EvaluationMember;
     input: I;
@@ -1404,15 +1512,15 @@ type EvaluationContext<T, I = {
     };
     wallet: WalletReader;
     /**
-     * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-     * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-     * test contexts that do not supply it.
+     * The member's linked Telegram account and their membership in the chats the project connected.
+     * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+     * is absent from older runtimes and test contexts that do not supply it.
      */
     telegram?: TelegramReader;
 } & IntegrationReaders<D>;
 type Evaluator<T, I = {
     photo: string;
-}, G = any, D extends readonly IntegrationModule[] = readonly []> = (ctx: EvaluationContext<T, I, G, D>) => Promise<Outcome>;
+}, G = any, D extends readonly KnownIntegrationModule[] = readonly []> = (ctx: EvaluationContext<T, I, G, D>) => Promise<Outcome>;
 declare const evaluators: {
     quiz(answerKey: QuizEvidence["answers"], options?: {
         minimumCorrect?: number;
@@ -1449,7 +1557,7 @@ type CompletionPolicy = ReturnType<typeof once> | ReturnType<typeof keyed> | Str
 /** The completion builders, with key callbacks reading quest `G`'s typed context. */
 type CompletionPolicies<S, G> = {
     once: typeof once;
-    keyed: (key: (ctx: QuestKeyedContext<S, G>) => string) => ReturnType<typeof keyed>;
+    keyed: (key: (ctx: QuestKeyedContext<S, G>) => string, options?: KeyedOptions) => ReturnType<typeof keyed>;
     streak: typeof streak;
     progress: (definition: ProgressDefinition<QuestKeyedContext<S, G>>) => ReturnType<typeof progress>;
 };
@@ -1498,6 +1606,10 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => QuestPresentation) | undefined;
     trigger: G & NoInfer<IntegerSettingBounds<G, T>>;
+    /**
+     * The modules the quest uses: `discord` and `x` from this module enable their readers. A
+     * module this SDK does not know, `{ provider }`, builds but types no reader.
+     */
     integrations?: D | undefined;
     requires?: readonly Prerequisite[];
     campaign?: CampaignDefinition;
@@ -1587,7 +1699,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Announcement[]) | undefined;
-    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
+    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<KnownModules<D>>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
      * complete and fresh sample of `metrics` (a subset of the tracker's declared metrics) gates the
@@ -1694,6 +1806,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             label: string;
             picker?: string | undefined;
             decimals?: number | undefined;
+            secret?: true | undefined;
             description?: string | undefined;
         } | {
             kind: "integer";
@@ -1866,6 +1979,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             kind: "once";
         } | {
             kind: "keyed";
+            across?: "members" | undefined;
         };
         visibility: "visible" | "hidden";
         profile: {
@@ -1880,6 +1994,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 balance: string;
             };
         }[];
+        integrationModules?: IntegrationModuleProvider[] | undefined;
         announcements?: ({
             action: "post-message";
             text: string;
@@ -1962,12 +2077,12 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         };
         wallet: WalletReader;
         /**
-         * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-         * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-         * test contexts that do not supply it.
+         * The member's linked Telegram account and their membership in the chats the project connected.
+         * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+         * is absent from older runtimes and test contexts that do not supply it.
          */
         telegram?: TelegramReader;
-    } & IntegrationReaders<readonly IntegrationModule[]> & {
+    } & IntegrationReaders<readonly KnownIntegrationModule[]> & {
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
@@ -1992,6 +2107,10 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => QuestPresentation) | undefined;
     trigger: G & NoInfer<IntegerSettingBounds<G, T>>;
+    /**
+     * The modules the quest uses: `discord` and `x` from this module enable their readers. A
+     * module this SDK does not know, `{ provider }`, builds but types no reader.
+     */
     integrations?: D | undefined;
     requires?: readonly Prerequisite[];
     campaign?: CampaignDefinition;
@@ -2081,7 +2200,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Announcement[]) | undefined;
-    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
+    evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<KnownModules<D>>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
      * complete and fresh sample of `metrics` (a subset of the tracker's declared metrics) gates the
@@ -2188,6 +2307,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             label: string;
             picker?: string | undefined;
             decimals?: number | undefined;
+            secret?: true | undefined;
             description?: string | undefined;
         } | {
             kind: "integer";
@@ -2360,6 +2480,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             kind: "once";
         } | {
             kind: "keyed";
+            across?: "members" | undefined;
         };
         visibility: "visible" | "hidden";
         profile: {
@@ -2374,6 +2495,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 balance: string;
             };
         }[];
+        integrationModules?: IntegrationModuleProvider[] | undefined;
         announcements?: ({
             action: "post-message";
             text: string;
@@ -2456,12 +2578,12 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         };
         wallet: WalletReader;
         /**
-         * Telegram membership in the chats the project connected. It needs no `integrations` entry;
-         * Relay provides it to every quest from SDK 1.23.0 on, and it is absent from older runtimes and
-         * test contexts that do not supply it.
+         * The member's linked Telegram account and their membership in the chats the project connected.
+         * It needs no `integrations` entry; Relay provides it to every quest from SDK 1.23.0 on, and it
+         * is absent from older runtimes and test contexts that do not supply it.
          */
         telegram?: TelegramReader;
-    } & IntegrationReaders<readonly IntegrationModule[]> & {
+    } & IntegrationReaders<readonly KnownIntegrationModule[]> & {
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
@@ -2476,4 +2598,4 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     }): Promise<Decision>;
 } & ResourceHandle<"quest">;
 
-export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, SolanaProgram, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletReader, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };
+export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, IntegrationModuleProvider, type KeyedContext, type KeyedOptions, KnownIntegrationModule, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, SolanaProgram, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletReader, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineOffer, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, leaderboardTiesWarning, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };