@domino-sdk/relay 1.53.1 → 1.55.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-BMDNcvwB.js';
+export { g as defineOffer } from './offers-BMDNcvwB.js';
+import { E as EngagementBudget, l as leaderboardDefinitionSchema, m as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-O6onGPmC.js';
+export { n as defineCampaign, o as defineGroup } from './groups-O6onGPmC.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-C6_uUh-s.js';
+export { D as DashboardInput, b as DashboardPanelInput, d as defineDashboard } from './integrations-C6_uUh-s.js';
+import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-BbdawqVy.js';
+export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-BbdawqVy.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;
@@ -179,15 +183,6 @@ declare function defineReferral(input: Omit<ReferralInput, "qualification" | "in
             amount: number;
         })[];
     };
-    qualification: {
-        kind: "signup";
-    } | {
-        kind: "quest";
-        quest: string;
-    } | {
-        kind: "external";
-    };
-    enabled: boolean;
     milestones: {
         id: string;
         count: number;
@@ -218,6 +213,15 @@ declare function defineReferral(input: Omit<ReferralInput, "qualification" | "in
             amount: number;
         })[];
     }[];
+    qualification: {
+        kind: "signup";
+    } | {
+        kind: "quest";
+        quest: string;
+    } | {
+        kind: "external";
+    };
+    enabled: boolean;
     bonuses: {
         id: string;
         balance: string;
@@ -253,15 +257,26 @@ 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;
+    title: string;
     access: "participants" | "public";
     score: {
         kind: "balance";
@@ -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?: ("discord" | "wallet" | "x" | "member" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -507,6 +531,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;
@@ -769,7 +810,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 +825,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 +852,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 +920,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 +1002,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 +1024,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 +1159,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 +1185,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 +1206,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 +1237,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
@@ -1148,15 +1276,15 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             group?: string | undefined;
         };
         tier: string;
+    } | {
+        kind: "points";
+        balance: string;
+        amount: number;
     } | {
         kind: "integration";
         provider: "discord";
         action: "grant-role";
         roleId: string;
-    } | {
-        kind: "points";
-        balance: string;
-        amount: number;
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Reward[]);
@@ -1231,6 +1359,9 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             kind: "resource";
             default: string;
             source: {
+                provider: "domino";
+                resource: "point-ledger";
+            } | {
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
@@ -1238,9 +1369,6 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 provider: "discord";
                 resource: "role";
                 assignable: boolean;
-            } | {
-                provider: "domino";
-                resource: "point-ledger";
             };
             label: string;
             description?: string | undefined;
@@ -1265,6 +1393,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";
@@ -1315,15 +1444,15 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 group?: string | undefined;
             };
             tier: string;
+        } | {
+            kind: "points";
+            balance: string;
+            amount: number;
         } | {
             kind: "integration";
             provider: "discord";
             action: "grant-role";
             roleId: string;
-        } | {
-            kind: "points";
-            balance: string;
-            amount: number;
         })[];
         humanReview: boolean;
         trigger: {
@@ -1345,7 +1474,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             actor?: "staff" | "member" | undefined;
         } | {
             kind: "manual";
-            input: "none" | "quiz" | "photo";
+            input: "photo" | "quiz" | "none";
             actor?: "staff" | "member" | undefined;
         } | {
             kind: "automatic";
@@ -1389,9 +1518,9 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                     path: string;
                     equals: string | number | boolean;
                 })[] | undefined;
-                enrollment?: "none" | "required" | undefined;
+                enrollment?: "required" | "none" | undefined;
                 since?: "activation" | "window" | "enrollment" | undefined;
-                historical?: "staff" | "claim" | "automatic" | undefined;
+                historical?: "automatic" | "staff" | "claim" | undefined;
                 content?: true | undefined;
             } | undefined;
         };
@@ -1414,6 +1543,9 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             title: string;
         })[];
         completion: {
+            kind: "streak";
+            days: number;
+        } | {
             kind: "progress";
             goal: {
                 kind: "count";
@@ -1430,9 +1562,6 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 durationMs: number;
             };
             repeat: "repeat" | "once";
-        } | {
-            kind: "streak";
-            days: number;
         } | {
             kind: "once";
         } | {
@@ -1458,7 +1587,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         campaign?: {
             key: string;
             title: string;
-            enrollment: "none" | "required";
+            enrollment: "required" | "none";
             window?: {
                 from: number;
                 until: number;
@@ -1469,6 +1598,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 +1649,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 +1687,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
@@ -1581,15 +1726,15 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             group?: string | undefined;
         };
         tier: string;
+    } | {
+        kind: "points";
+        balance: string;
+        amount: number;
     } | {
         kind: "integration";
         provider: "discord";
         action: "grant-role";
         roleId: string;
-    } | {
-        kind: "points";
-        balance: string;
-        amount: number;
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Reward[]);
@@ -1664,6 +1809,9 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             kind: "resource";
             default: string;
             source: {
+                provider: "domino";
+                resource: "point-ledger";
+            } | {
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
@@ -1671,9 +1819,6 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 provider: "discord";
                 resource: "role";
                 assignable: boolean;
-            } | {
-                provider: "domino";
-                resource: "point-ledger";
             };
             label: string;
             description?: string | undefined;
@@ -1698,6 +1843,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";
@@ -1748,15 +1894,15 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 group?: string | undefined;
             };
             tier: string;
+        } | {
+            kind: "points";
+            balance: string;
+            amount: number;
         } | {
             kind: "integration";
             provider: "discord";
             action: "grant-role";
             roleId: string;
-        } | {
-            kind: "points";
-            balance: string;
-            amount: number;
         })[];
         humanReview: boolean;
         trigger: {
@@ -1778,7 +1924,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             actor?: "staff" | "member" | undefined;
         } | {
             kind: "manual";
-            input: "none" | "quiz" | "photo";
+            input: "photo" | "quiz" | "none";
             actor?: "staff" | "member" | undefined;
         } | {
             kind: "automatic";
@@ -1822,9 +1968,9 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                     path: string;
                     equals: string | number | boolean;
                 })[] | undefined;
-                enrollment?: "none" | "required" | undefined;
+                enrollment?: "required" | "none" | undefined;
                 since?: "activation" | "window" | "enrollment" | undefined;
-                historical?: "staff" | "claim" | "automatic" | undefined;
+                historical?: "automatic" | "staff" | "claim" | undefined;
                 content?: true | undefined;
             } | undefined;
         };
@@ -1847,6 +1993,9 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             title: string;
         })[];
         completion: {
+            kind: "streak";
+            days: number;
+        } | {
             kind: "progress";
             goal: {
                 kind: "count";
@@ -1863,9 +2012,6 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 durationMs: number;
             };
             repeat: "repeat" | "once";
-        } | {
-            kind: "streak";
-            days: number;
         } | {
             kind: "once";
         } | {
@@ -1891,7 +2037,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         campaign?: {
             key: string;
             title: string;
-            enrollment: "none" | "required";
+            enrollment: "required" | "none";
             window?: {
                 from: number;
                 until: number;
@@ -1902,6 +2048,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 +2099,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, untracked, x };