@domino-sdk/relay 1.54.0 → 1.56.0

package/dist/authoring.d.ts

@@ -1,22 +1,26 @@
-import { x as xContentBodySchema, I as IdentityKind, n as customSourceSchema, W as WithRecordData, o as WithContent, p as WithAccountRoles, q as ResourceHandle, r as QuestHandle, L as LedgerReference, G as GroupHandle, u as TrackerSource, v as trackerDefinitionSchema, y as Tracker, z as TrackerData, B as SourceRoles, C as LedgerHandle, D as TrackerDataSchema, F as xSearchSourceSchema, X as XTweet, H as XContentMetric, J as TrackerTriggerPolicy, N as Where, P as MemberIdentity, U as TrackerTriggerContext, V as TrackerReader, Y as TextReviewInput, Z as TextResult, _ as PhotoResult, $ as Decision, a0 as rewardSchema, a1 as TrackerTriggerMode, a2 as RoleOf, a3 as WhereSetting, a4 as ContentBody, a5 as BadgeHandle, a6 as ContentMetricName, a7 as triggerSchema, d as QuestPresentation, e as QuestProfile, f as QuizEvidence, a8 as TieredRewardDefinition } from './schema-BJ9bOgpN.js';
-export { a9 as LedgerSetting, aa as TrackerPage, ab as TrackerReadQuery, ac as trackerDataSchema, ad as trackerTriggerContextSchema } from './schema-BJ9bOgpN.js';
+import { x as xContentBodySchema, I as IdentityKind, y as customSourceSchema, W as WithRecordData, z as WithContent, B as WithAccountRoles, C as ResourceHandle, D as QuestHandle, L as LedgerReference, G as GroupHandle, F as pointLedgerDeclarationSchema, H as TrackerSource, J as trackerDefinitionSchema, N as Tracker, U as TrackerData, V as SourceRoles, X as LedgerHandle, Y as TrackerDataSchema, Z as xSearchSourceSchema, _ as XTweet, $ as XContentMetric, a0 as TrackerTriggerPolicy, a1 as Where, a2 as MemberIdentity, P as PointBalance, a3 as ReferralHandle, a4 as TrackerTriggerContext, a5 as TrackerReader, a6 as TextReviewInput, a7 as TextResult, a8 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-C4m9RhCR.js';
+export { aj as LedgerSetting, ak as TrackerPage, al as TrackerReadQuery, am as trackerDataSchema, an as trackerTriggerContextSchema } from './schema-C4m9RhCR.js';
+import { M as MemberCompletion, B as Budget } from './capability-error-DSd8EMQC.js';
+export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-DSd8EMQC.js';
+import { d as ProfileReferral } from './profiles-BoOK03cR.js';
 import * as z from 'zod';
 export { z } from 'zod';
-import { f as badgeDeclarationSchema, B as Badge } from './offers-CH1RZekg.js';
-export { g as defineOffer } from './offers-CH1RZekg.js';
-import { E as EngagementBudget, s as leaderboardDefinitionSchema, t as AuthoringIdentity, u as pointLedgerDeclarationSchema, v as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-B5R1RCsl.js';
-export { w as defineCampaign, x as defineGroup } from './groups-B5R1RCsl.js';
+import { f as badgeDeclarationSchema, B as Badge } from './offers-CtzMeB7O.js';
+export { g as defineOffer } from './offers-CtzMeB7O.js';
+import { E as EngagementBudget, l as leaderboardDefinitionSchema, m as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-DPE004_V.js';
+export { n as defineCampaign, o as defineGroup } from './groups-DPE004_V.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-DRPENuZe.js';
 export { i as TelegramChatMember, j as TelegramChatMemberStatus, k as TelegramReactionData } from './accounts-DRPENuZe.js';
-import { Q as QuizContent, a as StreakPolicy } from './streaks-0YuipsUQ.js';
-import { R as ResourceSource, S as Setting, I as IntegrationModule, B as Budget, a as IntegerSettings } from './integrations-CllF-kWg.js';
-import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-BNah53go.js';
-export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-BNah53go.js';
-import { I as ImageReader, X as XReader } from './x-BfQcsDp0.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, I as IntegrationModule, a as BoundSettings } from './integrations-CcD5NPEA.js';
+export { D as DashboardInput, b as DashboardPanelInput, T as TikTokVideoBody, c as TikTokVideoMetric, Y as YouTubeShortBody, d as YouTubeShortMetric, e as defineDashboard } from './integrations-CcD5NPEA.js';
+import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-wTiYGdgA.js';
+export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-wTiYGdgA.js';
+import { I as ImageReader, X as XReader } from './x-1czZFVUW.js';
 import { h as WalletReader } from './wallet-Ac7OFpOr.js';
 export { i as CosmosDenom, a as CosmosNetwork, E as EvmChainId, j as WalletBalance, k as WalletBalanceQuery, l as cosmosDenomSchema, m as cosmosNetworkSchema, n as isEvmChainId } from './wallet-Ac7OFpOr.js';
-export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-FQGGb5xS.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
+import './analytics-URV-mxjH.js';
 
 declare function defineBadge(input: z.input<typeof badgeDeclarationSchema>): {
     name: string;
@@ -253,12 +257,23 @@ declare function earned(options?: Omit<EarnedScore, "kind" | "quests"> & {
     quests?: QuestHandle[];
     kind: "earned";
 };
-declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" | "balance" | "group" | "score"> & AuthoringIdentity & {
+type SettlementInput = NonNullable<LeaderboardInput["settle"]>;
+declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" | "balance" | "group" | "score" | "settle"> & AuthoringIdentity & {
     ledger: LedgerReference;
     group?: GroupHandle;
     score?: Exclude<LeaderboardInput["score"], {
         kind: "earned";
     }> | ReturnType<typeof earned>;
+    /**
+     * A points pool's `ledger` takes a ledger handle or key. `prizes` may be left out when the
+     * settlement has a pool.
+     */
+    settle?: Omit<SettlementInput, "pool" | "prizes"> & {
+        prizes?: SettlementInput["prizes"];
+        pool?: Omit<NonNullable<SettlementInput["pool"]>, "ledger"> & {
+            ledger?: LedgerReference;
+        };
+    };
 }): {
     title: string;
     balance: string;
@@ -331,6 +346,15 @@ declare function defineLeaderboard(input: Omit<LeaderboardInput, "key" | "id" |
                 amount: number;
             })[];
         }[];
+        pool?: {
+            amount: string;
+            unit: "points" | {
+                code: string;
+                decimals: number;
+            };
+            ledger?: string | undefined;
+            minScore?: number | undefined;
+        } | undefined;
     } | undefined;
     group?: string | undefined;
 } & ResourceHandle<"leaderboard">;
@@ -450,7 +474,7 @@ declare const telegram: {
     reactions(): {
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -467,6 +491,88 @@ declare const telegram: {
         reactorIsAdmin: boolean;
     }> & WithAccountRoles<"author" | "messageAuthor">;
 };
+/**
+ * YouTube, read through the channels members link as creator accounts.
+ *
+ * - `youtube.shorts()`: a tracker source of the Shorts members publish on their linked channels.
+ *   Each record is one Short, keyed by its video ID: its `author` is the channel, attributed to the
+ *   member who linked it, and `occurredAt` is when it was published. Its content is
+ *   `YouTubeShortBody`, measured by `views`, `likes` and `comments`, so `content()` quests,
+ *   `performance` and engagement rules work on it. Relay looks for new Shorts and refreshes the
+ *   counters every `refreshSeconds` of the tracker. A video that is deleted or made private is a
+ *   content removal.
+ *
+ * In SDK 1.x the source is a custom source whose namespace Relay reserves: only Relay writes its
+ * records, and their accounts are YouTube channels whatever `identities` says.
+ */
+declare const youtube: {
+    shorts(): {
+        kind: "custom";
+        namespace: string;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+    } & WithRecordData<ContentData<{
+        title: string;
+        description: string;
+        tags: string[];
+        durationSeconds: number;
+        publishedAt: number;
+    }, "likes" | "views" | "comments">> & WithContent<{
+        title: string;
+        description: string;
+        tags: string[];
+        durationSeconds: number;
+        publishedAt: number;
+    }, "likes" | "views" | "comments"> & WithAccountRoles<"author">;
+};
+/**
+ * TikTok, read through the accounts members link as creator accounts.
+ *
+ * - `tiktok.videos()`: a tracker source of the public videos members post on their linked TikTok
+ *   accounts, read with each member's own token. Each record is one video, keyed by its video ID:
+ *   its `author` is the account's `open_id`, attributed to the member who linked it, and
+ *   `occurredAt` is when it was posted. Its content is `TikTokVideoBody`, measured by `views`,
+ *   `likes`, `comments` and `shares`, so `content()` quests, `performance` and engagement rules
+ *   work on it. Relay looks for new videos and refreshes the counters every `refreshSeconds` of the
+ *   tracker. A video its owner's account no longer returns is a content removal.
+ *
+ * In SDK 1.x the source is a custom source whose namespace Relay reserves: only Relay writes its
+ * records, and their accounts are TikTok accounts whatever `identities` says.
+ */
+declare const tiktok: {
+    videos(): {
+        kind: "custom";
+        namespace: string;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+    } & WithRecordData<ContentData<{
+        title: string;
+        description: string;
+        durationSeconds: number;
+        width: number;
+        height: number;
+        createdAt: number;
+        shareUrl: string;
+        isAigc: boolean;
+    }, "likes" | "views" | "comments" | "shares">> & WithContent<{
+        title: string;
+        description: string;
+        durationSeconds: number;
+        width: number;
+        height: number;
+        createdAt: number;
+        shareUrl: string;
+        isAigc: boolean;
+    }, "likes" | "views" | "comments" | "shares"> & WithAccountRoles<"author">;
+};
 declare const pointLedgers: () => ResourceSource;
 type Label = {
     label: string;
@@ -507,6 +613,23 @@ declare const settings: {
     telegramChat(options: Label & {
         default?: string;
     }): Setting<"text", z.ZodDefault<z.ZodString>>;
+    /**
+     * A non-negative token amount in base units, as an integer string such as `"1000000"`: exact at
+     * any scale, so an 18-decimal threshold fits. A tracker filter may compare with it
+     * (`gte: { setting }`). With `decimals`, Console shows and edits it in whole tokens.
+     */
+    amount(options: Label & {
+        default: string;
+        decimals?: number;
+    }): AmountSetting<z.ZodDefault<z.ZodString>>;
+    /**
+     * A chain `ctx.wallet.balance()` reads: `"solana"` (or Solana mainnet's CAIP-2 ID), or an EVM
+     * chain's CAIP-2 ID such as `"eip155:8453"`. Typed as the query's chain, so it passes to
+     * `ctx.wallet.balance({ chain })` as it is.
+     */
+    chain(options: Label & {
+        default: BalanceChain;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<"solana" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" | `eip155:${number}`, string>>>>;
     integer(options: Label & {
         default: number;
         min: number;
@@ -546,10 +669,10 @@ declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
     tier: string;
 };
 /**
- * A reward that adds the member to a group when the completion's rewards are delivered. The
- * group must exist, unarchived, where the quest publishes; operators create it in Console
- * **Groups**. Revoking the completion removes the membership unless an operator's add or another
- * unrevoked completion also backs it.
+ * 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.
  */
 declare const groupMembership: (group: GroupHandle) => {
     reward: {
@@ -769,7 +892,8 @@ type Supplied<G, K extends string, Present, Base> = unknown extends G ? Base | n
 type ContextTracker<G> = Supplied<G, "tracker", TrackerTriggerContext<TriggerData<G>, TriggerBody<G>>, TrackerTriggerContext>;
 /**
  * What a `keyed()` completion key reads. TypeScript cannot carry the trigger into a completion
- * built inline, so `tracker` stays nullable here; the evaluator's `ctx.tracker` is typed.
+ * built inline, so `tracker` stays nullable here; the builder form,
+ * `completion: ({ keyed }) => keyed((ctx) => …)`, reads a {@link QuestKeyedContext}.
  */
 type KeyedContext = {
     member: {
@@ -783,6 +907,15 @@ type KeyedContext = {
     /** The attempt's evaluation time; see {@link EvaluationContext.now}. */
     now: number;
 };
+/**
+ * What a completion key reads in the builder form, `completion: ({ keyed }) => keyed((ctx) => …)`:
+ * a {@link KeyedContext} typed from quest `G`'s trigger, with its settings `S`.
+ */
+type QuestKeyedContext<S, G> = Omit<KeyedContext, "tracker"> & {
+    settings: S;
+    /** The pinned tracker observation: non-null and typed for a tracker trigger, null for others. */
+    tracker: ContextTracker<G>;
+};
 declare const budget: (definition: Omit<Budget, "id" | "cost"> & {
     key: string;
     cost: number | {
@@ -801,13 +934,14 @@ declare const keyed: (key: (ctx: KeyedContext) => string) => {
     kind: "keyed";
     key: (ctx: KeyedContext) => string;
 };
-/** Accepted evidence contributes once under its distinct key; Relay commits progress with rewards. */
-declare const progress: (definition: {
-    distinct: (ctx: KeyedContext) => string;
+type ProgressDefinition<C> = {
+    distinct: (ctx: C) => string;
     goal: ReturnType<typeof count>;
     window?: ReturnType<typeof calendar>;
     repeat?: "once" | "repeat";
-}) => {
+};
+/** Accepted evidence contributes once under its distinct key; Relay commits progress with rewards. */
+declare const progress: (definition: ProgressDefinition<KeyedContext>) => {
     distinct: (ctx: KeyedContext) => string;
     kind: "progress";
     goal: {
@@ -868,12 +1002,22 @@ declare function defineTieredReward<const T extends readonly {
 declare const once: () => {
     kind: "once";
 };
+type CompletionKeyOption = {
+    /**
+     * The completion key for a `keyed(...)` quest, in place of its key callback. Other policies
+     * ignore it: `once()` and `streak(...)` key their own completions, `progress(...)` uses its
+     * `distinct(...)`, and a content quest uses its content item. `runQuest` reports an ignored key.
+     */
+    completionKey?: string;
+};
 type Outcome = (Omit<Extract<Decision, {
     kind: "accept";
-}>, "rewards"> & {
+}>, "rewards" | "completionKey"> & {
     rewards?: Reward[];
-}) | Exclude<Decision, {
-    kind: "accept";
+} & CompletionKeyOption) | (Omit<Extract<Decision, {
+    kind: "review";
+}>, "completionKey"> & CompletionKeyOption) | Exclude<Decision, {
+    kind: "accept" | "review";
 }>;
 /**
  * A performance evaluator's answer. It gates the rewards content evaluation already selected, so
@@ -940,7 +1084,20 @@ declare const decision: {
     };
     review: typeof review;
 };
-/** The member an attempt evaluates. */
+/** What `ctx.member.completions()` reads. */
+type MemberCompletionQuery = {
+    /** Only this quest's completions: its handle or key. */
+    quest?: QuestHandle | string;
+    /** Only completions recorded at or after this time, in epoch milliseconds on the member's clock. */
+    since?: number;
+    /** At most this many, newest first: 100 by default, and never more than 100. */
+    limit?: number;
+};
+/**
+ * The member an attempt evaluates. Relay and the testing kit create it; quest code only reads it.
+ *
+ * @compat sealed
+ */
 type EvaluationMember = {
     id: string;
     /**
@@ -949,6 +1106,39 @@ type EvaluationMember = {
      * this evaluation. Null when the member has none. `ctx.wallet.list()` reads wallets.
      */
     identities(): Promise<MemberIdentity[] | null>;
+    /**
+     * The member's balance in a point ledger of the project, by its handle or key, as
+     * `relay.me.balances()` returns it. The member's balances are pinned once per evaluation run at
+     * the first call: points awarded or spent afterwards, including this attempt's own reward, do not
+     * change this evaluation. An unknown ledger fails with a `CapabilityError` of code `author-error`.
+     */
+    balance(ledger: LedgerHandle | string): Promise<PointBalance>;
+    /**
+     * The member's accepted, unrevoked quest completions in the project, newest first; completions
+     * recorded without a time come last. Pinned once per evaluation run at the first call, like
+     * `balance`. An unknown quest fails with a `CapabilityError` of code `author-error`.
+     */
+    completions(query?: MemberCompletionQuery): Promise<MemberCompletion[]>;
+    /**
+     * Keys of the project's unarchived groups the member belongs to, in byte order. Pinned once per
+     * evaluation run at the first call, like `balance`.
+     */
+    groups(): Promise<string[]>;
+    /**
+     * Whether the member's enrollment in a campaign, by its definition or key, is active: false once
+     * they withdraw and for a campaign they never enrolled in. Pinned once per evaluation run at the
+     * first call, like `balance`. A campaign no active quest declares and the member never enrolled
+     * in fails with a `CapabilityError` of code `author-error`.
+     */
+    enrolled(campaign: Pick<CampaignDefinition, "key"> | string): Promise<boolean>;
+    /**
+     * The member's progress as inviter in a referral program, by its handle or key, as
+     * `relay.profiles.referral()` returns it: the members they invited, those who qualified in the
+     * program and the milestones reached. Never codes or accounts. Pinned once per evaluation run at
+     * the first call, like `balance`. An unknown program fails with a `CapabilityError` of code
+     * `author-error`.
+     */
+    referrals(program: ReferralHandle | string): Promise<ProfileReferral>;
 };
 /** One project-calendar day, with epoch-millisecond bounds. */
 type EvaluationCalendarDay = {
@@ -1051,16 +1241,24 @@ type QuestInput<T extends Trigger> = T extends {
     input: "url";
 } ? UrlEvidence : Record<string, never>;
 /**
- * Rejects a trigger whose filter compares with settings that are not integer settings of the
- * quest, naming them.
+ * Rejects a trigger whose filter compares with settings that are not integer or amount settings
+ * of the quest, naming them.
  */
 type IntegerSettingBounds<G, T> = [
-    Exclude<TriggerSettings<G>, IntegerSettings<T>>
+    Exclude<TriggerSettings<G>, BoundSettings<T>>
 ] extends [never] ? unknown : {
-    readonly "The tracker filter compares with settings that are not integer settings of this quest": Exclude<TriggerSettings<G>, IntegerSettings<T>>;
+    readonly "The tracker filter compares with settings that are not integer or amount settings of this quest": Exclude<TriggerSettings<G>, BoundSettings<T>>;
+};
+type CompletionPolicy = ReturnType<typeof once> | ReturnType<typeof keyed> | StreakPolicy | ReturnType<typeof progress>;
+/** 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>;
+    streak: typeof streak;
+    progress: (definition: ProgressDefinition<QuestKeyedContext<S, G>>) => ReturnType<typeof progress>;
 };
 /** How a quest completes: a content quest once per content item, so it takes no `completion`. */
-type CompletionFor<G> = IsContent<G> extends true ? {
+type CompletionFor<G, S> = IsContent<G> extends true ? {
     /** A content quest completes once per content item; it takes no completion. */
     completion?: never;
 } : G extends {
@@ -1069,7 +1267,12 @@ type CompletionFor<G> = IsContent<G> extends true ? {
 } ? {
     completion: ReturnType<typeof once>;
 } : {
-    completion: ReturnType<typeof once> | ReturnType<typeof keyed> | StreakPolicy | ReturnType<typeof progress>;
+    /**
+     * A policy, or a function building one from the policies it receives:
+     * `({ keyed }) => keyed((ctx) => ctx.tracker.record.data.messageId)` types `ctx` from the
+     * quest's trigger and settings, which a policy built inline cannot.
+     */
+    completion: CompletionPolicy | ((policies: CompletionPolicies<S, G>) => CompletionPolicy);
 };
 /** What a content quest's performance stage reads: the declared metrics it chose, fresh. */
 type PerformanceContext<S, G, M extends string> = {
@@ -1085,7 +1288,7 @@ type PerformanceContext<S, G, M extends string> = {
     observedAt: number;
 };
 /** A concrete quest: prerequisite-only automatic triggers need at least one prerequisite. */
-declare const defineQuest: <T extends Record<string, Setting>, const G extends Trigger, const D extends readonly IntegrationModule[] = readonly [], const M extends readonly [string, ...string[]] = readonly [string, ...string[]]>(definition: AuthoringIdentity & CompletionFor<G> & (G extends {
+declare const defineQuest: <T extends Record<string, Setting>, const G extends Trigger, const D extends readonly IntegrationModule[] = readonly [], const M extends readonly [string, ...string[]] = readonly [string, ...string[]]>(definition: AuthoringIdentity & CompletionFor<G, z.core.$InferObjectOutput<T, {}>> & (G extends {
     kind: "automatic";
     tracker?: never;
 } ? {
@@ -1116,6 +1319,13 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
      * Only for quests members submit. Omit it for no cooldown.
      */
     retryCooldownMs?: number;
+    /**
+     * Milliseconds a member waits after an accepted completion, of any key, before submitting
+     * again: `5_400_000` makes a second story count only 90 minutes after the first was
+     * accepted. Only for repeatable quests members submit; same bounds as `retryCooldownMs`.
+     * Omit it for no cooldown.
+     */
+    completionCooldownMs?: number;
     /**
      * Whether staff can review this quest's attempts. Human review is on unless this returns
      * `{ enabled: false }`. With it off, `decision.review(...)` becomes a reject that keeps the
@@ -1192,7 +1402,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "discord" | "x" | "google" | "apple";
+                provider: "x" | "discord" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -1216,7 +1426,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 } | undefined;
             } | undefined;
         };
-        integrations: ("discord" | "x")[];
+        integrations: ("x" | "discord")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -1265,6 +1475,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             multiline: boolean;
             label: string;
             picker?: string | undefined;
+            decimals?: number | undefined;
             description?: string | undefined;
         } | {
             kind: "integer";
@@ -1469,6 +1680,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             until: number;
         } | undefined;
         retryCooldownMs?: number | undefined;
+        completionCooldownMs?: number | undefined;
     };
     evaluate(ctx: {
         settings: unknown;
@@ -1519,11 +1731,19 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
+        /**
+         * The testing kit's: receives what the run did that had no effect, such as a
+         * `completionKey` the completion policy ignores. Relay's hosted runtime does not pass it.
+         */
+        diagnose?: ((diagnostic: {
+            code: string;
+            message: string;
+        }) => void) | undefined;
     }): Promise<Decision>;
 } & ResourceHandle<"quest">;
 /** Publish this artifact as a reusable type. Its key names the type;
  * Console instances receive independent quest identities and pinned versions. */
-declare const defineQuestType: <T extends Record<string, Setting>, const G extends Trigger, const D extends readonly IntegrationModule[] = readonly [], const M extends readonly [string, ...string[]] = readonly [string, ...string[]]>(definition: AuthoringIdentity & CompletionFor<G> & {
+declare const defineQuestType: <T extends Record<string, Setting>, const G extends Trigger, const D extends readonly IntegrationModule[] = readonly [], const M extends readonly [string, ...string[]] = readonly [string, ...string[]]>(definition: AuthoringIdentity & CompletionFor<G, z.core.$InferObjectOutput<T, {}>> & {
     title: string | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => string);
@@ -1549,6 +1769,13 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
      * Only for quests members submit. Omit it for no cooldown.
      */
     retryCooldownMs?: number;
+    /**
+     * Milliseconds a member waits after an accepted completion, of any key, before submitting
+     * again: `5_400_000` makes a second story count only 90 minutes after the first was
+     * accepted. Only for repeatable quests members submit; same bounds as `retryCooldownMs`.
+     * Omit it for no cooldown.
+     */
+    completionCooldownMs?: number;
     /**
      * Whether staff can review this quest's attempts. Human review is on unless this returns
      * `{ enabled: false }`. With it off, `decision.review(...)` becomes a reject that keeps the
@@ -1625,7 +1852,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "discord" | "x" | "google" | "apple";
+                provider: "x" | "discord" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -1649,7 +1876,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 } | undefined;
             } | undefined;
         };
-        integrations: ("discord" | "x")[];
+        integrations: ("x" | "discord")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -1698,6 +1925,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             multiline: boolean;
             label: string;
             picker?: string | undefined;
+            decimals?: number | undefined;
             description?: string | undefined;
         } | {
             kind: "integer";
@@ -1902,6 +2130,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             until: number;
         } | undefined;
         retryCooldownMs?: number | undefined;
+        completionCooldownMs?: number | undefined;
     };
     evaluate(ctx: {
         settings: unknown;
@@ -1952,7 +2181,15 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         rewards: Reward[];
         humanReview: boolean;
         performance?: unknown;
+        /**
+         * The testing kit's: receives what the run did that had no effect, such as a
+         * `completionKey` the completion policy ignores. Relay's hosted runtime does not pass it.
+         */
+        diagnose?: ((diagnostic: {
+            code: string;
+            message: string;
+        }) => void) | undefined;
     }): Promise<Decision>;
 } & ResourceHandle<"quest">;
 
-export { ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberIdentity, type Outcome, type PerformanceContext, type PerformanceOutcome, QuestHandle, RoleOf, Setting, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletReader, 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, keyed, manual, once, pointLedgers, points, progress, questCompleted, rolling, settings, staffHandover, streak, telegram, untracked, x };
+export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletReader, 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, keyed, manual, once, pointLedgers, points, progress, questCompleted, rolling, settings, staffHandover, streak, telegram, tiktok, untracked, x, youtube };