@helyx/bot 1.5.4 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.7.0
+
+### Minor Changes
+
+- Add the built-in private /help command with module selection, reviewed answer choices and local self-host fallback. Keep question selection and its answer in the same private message, show the original question above choices, and use a compact FAQ ID footer. Add opt-in encrypted online Help enrolment and fail closed for unavailable hosted publication state. Integrate authenticated Server Overview reads, bounded Discord profiles and protected invite provenance across direct, Cloud Connect and sharded runtimes.
+
+## 1.6.0
+
+### Minor Changes
+
+- Add public `/proc` process information for hosted and self-hosted bots, replacing
+  the private `/dev proc` path. Keep the reply private and independent of database
+  availability.
+
+  Add a PebbleHost starter profile with direct Node CLI scripts, flat starter ZIPs,
+  compact quoted environment examples and matching guided environment builder
+  output. Preserve existing custom settings and encryption keys when rebuilding
+  an environment file, and recognize quoted placeholders during setup.
+
 ## 1.5.4
 
 ### Patch Changes

package/README.md

@@ -164,8 +164,11 @@ paths are read-only:
 
 - `/dev shards` reports bounded shard health, including the unsharded
   compatibility baseline;
-- `/dev bot` reports the bot build and bounded installed-module versions;
-- `/dev proc` reports safe metrics for the process handling the command.
+- `/dev bot` reports the bot build and bounded installed-module versions.
+
+The public `/proc` command reports the same safe process metrics on hosted and
+self-hosted bots, in a server or bot DM. Anyone can run it; replies are ephemeral.
+It works independently of database and module enablement checks.
 
 On the official hosted bot only,
 `HELYX_HOSTED_MODERATION_ENABLED=true` adds `/dev leave` and `/dev blacklist`.

package/command-root-catalogue.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "revision": 2,
+  "revision": 6,
   "roots": [
     { "name": "access", "type": 1, "ownerModuleId": "helyx.account-gate" },
     { "name": "access", "type": 1, "ownerModuleId": "helyx.verification" },
@@ -17,6 +17,7 @@
     { "name": "games", "type": 1, "ownerModuleId": "helyx.counting" },
     { "name": "games", "type": 1, "ownerModuleId": "helyx.trivia" },
     { "name": "giveaway", "type": 1, "ownerModuleId": "helyx.giveaways" },
+    { "name": "help", "type": 1, "ownerModuleId": "helyx.help" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.cloud-connect" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.management" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.oauth" },
@@ -26,6 +27,7 @@
     { "name": "mod", "type": 1, "ownerModuleId": "helyx.moderation" },
     { "name": "nexus", "type": 1, "ownerModuleId": "helyx.nexus-core" },
     { "name": "poll", "type": 1, "ownerModuleId": "helyx.polls" },
+    { "name": "proc", "type": 1, "ownerModuleId": "helyx.process-info" },
     { "name": "profile", "type": 1, "ownerModuleId": "helyx.achievements" },
     { "name": "profile", "type": 1, "ownerModuleId": "helyx.levels" },
     { "name": "submit", "type": 1, "ownerModuleId": "helyx.feedback" },
@@ -61,6 +63,13 @@
         "sourcePath": "apps/bot/src/diagnostic-command.ts",
         "version": "0.1.0"
       },
+      {
+        "commands": ["help"],
+        "moduleId": "helyx.help",
+        "releaseStatus": "live",
+        "sourcePath": "apps/bot/src/help-module.ts",
+        "version": "0.1.0"
+      },
       {
         "commands": ["helyx.modules"],
         "moduleId": "helyx.management",
@@ -96,6 +105,13 @@
         "sourcePath": "apps/bot/src/privacy-module.ts",
         "version": "0.1.0"
       },
+      {
+        "commands": ["proc"],
+        "moduleId": "helyx.process-info",
+        "releaseStatus": "live",
+        "sourcePath": "apps/bot/src/process-info-module.ts",
+        "version": "0.1.0"
+      },
       {
         "commands": ["helyx.bug"],
         "moduleId": "helyx.support",
@@ -116,7 +132,7 @@
         "moduleId": "helyx.account-gate",
         "packageName": "@helyx/module-account-gate",
         "releaseStatus": "live",
-        "version": "2.1.2"
+        "version": "2.1.3"
       },
       {
         "commands": [
@@ -127,7 +143,7 @@
         "moduleId": "helyx.achievements",
         "packageName": "@helyx/module-achievements",
         "releaseStatus": "live",
-        "version": "2.1.3"
+        "version": "2.1.4"
       },
       {
         "commands": ["afk"],
@@ -276,7 +292,7 @@
         "moduleId": "helyx.reactionroles",
         "packageName": "@helyx/module-reactionroles",
         "releaseStatus": "live",
-        "version": "1.1.2"
+        "version": "1.1.3"
       },
       {
         "commands": [],
@@ -448,5 +464,5 @@
       }
     ]
   },
-  "fingerprint": "a33abb53dd9862ee73e43515eae7fa049cd62e8c170473f82bd268878621d55e"
+  "fingerprint": "9bd09abbfbaaac0ddb932b6e25911b9a2eb8a3dd5febe92f5862ef903534b2e5"
 }

package/dist/cloud-connector.js

@@ -904,6 +904,8 @@ function connectorCapabilities() {
         "installation.health.read.v1",
         "guild.state.read.v1",
         "guild.user-identities.read.v1",
+        "guild.overview.read.v1",
+        "guild.overview.invite.revoke.v1",
         "guild.dashboard.access.read.v1",
         "guild.access-policy.read.v1",
         "guild.access-policy.write.v1",

package/dist/cloud-control-dispatcher.js

@@ -18,6 +18,26 @@ export class CloudControlDispatcher {
             : undefined;
         let result;
         switch (request.operation) {
+            case "guild.overview.read.v1": {
+                const input = parseOperationInput(request.operation, request.input);
+                if (!this.control.readServerOverview)
+                    throw new Error("Overview is unavailable");
+                result = await this.control.readServerOverview({
+                    ...input,
+                    actorUserId: requiredActor(actorUserId),
+                });
+                break;
+            }
+            case "guild.overview.invite.revoke.v1": {
+                const input = parseOperationInput(request.operation, request.input);
+                if (!this.control.revokeServerOverviewInvite)
+                    throw new Error("Invite management is unavailable");
+                result = await this.control.revokeServerOverviewInvite({
+                    ...input,
+                    actorUserId: requiredActor(actorUserId),
+                });
+                break;
+            }
             case "installation.health.read.v1":
                 parseOperationInput(request.operation, request.input);
                 result = {

package/dist/command-registration-policy.js

@@ -6,6 +6,8 @@ const platformGlobalModuleIds = new Set([
     "helyx.oauth",
     "helyx.permissions",
     "helyx.privacy",
+    "helyx.process-info",
+    "helyx.help",
     "helyx.premium-activation",
 ]);
 const deploymentModuleIds = new Set(["helyx.cloud-connect"]);

package/dist/control-directory-contracts.d.ts

@@ -0,0 +1,50 @@
+import type { DiscordUserIdentityControl } from "@helyx/control-protocol/discord-user-identities";
+import type { MessageResponse, PermissionActor, PublicAchievementProjectionPage } from "@helyx/sdk";
+import type { OverviewDiscordDirectory } from "./server-overview-discord.js";
+export interface BotControlGuildResources {
+    botGuildPermissions?: string[];
+    channels: Array<{
+        id: string;
+        name: string;
+        type: "guild_text" | "guild_announcement" | "guild_category" | "guild_forum" | "guild_media";
+    }>;
+    roles: Array<{
+        id: string;
+        name: string;
+        colour: string;
+        position: number;
+    }>;
+}
+export interface BotPublicModuleProjection {
+    server: {
+        id: string;
+        name: string;
+        memberCount: number;
+    };
+    projection: PublicAchievementProjectionPage;
+}
+export type BotGuildPresenceState = "installed" | "not_installed" | "unknown" | "unavailable";
+export interface BotGuildPresenceObservation {
+    guildId: string;
+    state: BotGuildPresenceState;
+    observedAt: string;
+}
+export interface BotControlGuildResourceDirectory extends DiscordUserIdentityControl {
+    overview?: OverviewDiscordDirectory;
+    listGuildPresence(guildIds: readonly string[]): Promise<BotGuildPresenceObservation[]>;
+    getGuildResources(guildId: string): Promise<BotControlGuildResources>;
+    getGuildPublicSummary(guildId: string): Promise<{
+        id: string;
+        name: string;
+        memberCount: number;
+    }>;
+    sendToChannel(channelId: string, response: MessageResponse): Promise<{
+        messageId: string;
+    }>;
+    deleteChannelMessage(channelId: string, messageId: string): Promise<void>;
+    editChannelMessage(channelId: string, messageId: string, response: MessageResponse): Promise<void>;
+    addChannelMessageReaction(channelId: string, messageId: string, emojiIdentifier: string): Promise<void>;
+    resolveActor(guildId: string, actorUserId: string): Promise<PermissionActor>;
+    sendPrivateSupportNotification?(guildId: string, channelId: string, response: MessageResponse, notificationId: string): Promise<void>;
+}
+//# sourceMappingURL=control-directory-contracts.d.ts.map

package/dist/control-directory-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=control-directory-contracts.js.map

package/dist/control-server-schemas.d.ts

@@ -8,9 +8,9 @@ export declare const permissionState: z.ZodObject<{
     module: z.ZodObject<{
         preset: z.ZodEnum<{
             everyone: "everyone";
+            custom: "custom";
             moderators: "moderators";
             administrators: "administrators";
-            custom: "custom";
         }>;
         allowedRoleIds: z.ZodArray<z.ZodString>;
         deniedRoleIds: z.ZodArray<z.ZodString>;
@@ -22,9 +22,9 @@ export declare const permissionState: z.ZodObject<{
         policy: z.ZodObject<{
             preset: z.ZodEnum<{
                 everyone: "everyone";
+                custom: "custom";
                 moderators: "moderators";
                 administrators: "administrators";
-                custom: "custom";
             }>;
             allowedRoleIds: z.ZodArray<z.ZodString>;
             deniedRoleIds: z.ZodArray<z.ZodString>;
@@ -59,8 +59,8 @@ export declare const managedResourceDetailSchema: z.ZodObject<{
     availableActionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     notices: z.ZodOptional<z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
-            info: "info";
             warning: "warning";
+            info: "info";
         }>;
         message: z.ZodString;
     }, z.core.$strict>>>;

package/dist/control-server.d.ts

@@ -1,9 +1,13 @@
+import type { BotControlGuildResources, BotPublicModuleProjection, BotGuildPresenceObservation, BotControlGuildResourceDirectory } from "./control-directory-contracts.js";
+export type { BotControlGuildResources, BotPublicModuleProjection, BotGuildPresenceState, BotGuildPresenceObservation, BotControlGuildResourceDirectory, } from "./control-directory-contracts.js";
 import { type DiscordUserIdentityControl, type DiscordUserIdentityRequest } from "@helyx/control-protocol/discord-user-identities";
+import type { ServerOverviewControl } from "@helyx/control-protocol";
+import { type OverviewDiscordDirectory } from "./server-overview-discord.js";
 import { AuditRepository, GuildAccessPolicyRepository, InstallationRepository, ModuleLoggingPolicyRepository, PermissionPolicyRepository, type DatabasePool, type GuildShardOwnership } from "@helyx/database";
 import type { MysqlPool } from "@helyx/database-mysql";
 import type { CreatorOnboardingRequest, CreatorOnboardingResponse } from "@helyx/sdk";
 export { mapBotControlError, safeBotControlFieldError, } from "./control-error-mapping.js";
-import { type DashboardActionInspection, type DashboardActionResult, type FeatureAccessDecision, type GuildAccessPolicy, type ManagedResourceCreationIntent, type ManagedResourceDetail, type ManagedResourcePage, type ManagedResourceRelationPage, type ManagedResourceValue, type MessageResponse, type ModuleDefinition, type OAuthConsumerCleanupResult, type PermissionActor, type PrivacyCapturePage, type PrivacyErasePage, type PrivacyProviderExecutor, type PublicAchievementProjectionPage, type ServiceAccess } from "@helyx/sdk";
+import { type DashboardActionInspection, type DashboardActionResult, type FeatureAccessDecision, type GuildAccessPolicy, type ManagedResourceCreationIntent, type ManagedResourceDetail, type ManagedResourcePage, type ManagedResourceRelationPage, type ManagedResourceValue, type MessageResponse, type ModuleDefinition, type OAuthConsumerCleanupResult, type PermissionActor, type PrivacyCapturePage, type PrivacyErasePage, type PrivacyProviderExecutor, type ServiceAccess } from "@helyx/sdk";
 import { type ActionReceipt, type SignedAssessmentEnvelope } from "@helyx/verification-contracts";
 import { type Client } from "discord.js";
 import { type FastifyInstance } from "fastify";
@@ -29,53 +33,10 @@ interface DashboardLoggingPolicy {
     enabled: boolean;
     version: number;
 }
-export interface BotControlGuildResources {
-    channels: Array<{
-        id: string;
-        name: string;
-        type: "guild_text" | "guild_announcement" | "guild_category" | "guild_forum" | "guild_media";
-    }>;
-    roles: Array<{
-        id: string;
-        name: string;
-        colour: string;
-        position: number;
-    }>;
-}
-export interface BotPublicModuleProjection {
-    server: {
-        id: string;
-        name: string;
-        memberCount: number;
-    };
-    projection: PublicAchievementProjectionPage;
-}
-export type BotGuildPresenceState = "installed" | "not_installed" | "unknown" | "unavailable";
-export interface BotGuildPresenceObservation {
-    guildId: string;
-    state: BotGuildPresenceState;
-    observedAt: string;
-}
-export interface BotControlGuildResourceDirectory extends DiscordUserIdentityControl {
-    listGuildPresence(guildIds: readonly string[]): Promise<BotGuildPresenceObservation[]>;
-    getGuildResources(guildId: string): Promise<BotControlGuildResources>;
-    getGuildPublicSummary(guildId: string): Promise<{
-        id: string;
-        name: string;
-        memberCount: number;
-    }>;
-    sendToChannel(channelId: string, response: MessageResponse): Promise<{
-        messageId: string;
-    }>;
-    deleteChannelMessage(channelId: string, messageId: string): Promise<void>;
-    editChannelMessage(channelId: string, messageId: string, response: MessageResponse): Promise<void>;
-    addChannelMessageReaction(channelId: string, messageId: string, emojiIdentifier: string): Promise<void>;
-    resolveActor(guildId: string, actorUserId: string): Promise<PermissionActor>;
-    sendPrivateSupportNotification?(guildId: string, channelId: string, response: MessageResponse, notificationId: string): Promise<void>;
-}
 export declare class DiscordGuildResourceDirectory implements BotControlGuildResourceDirectory {
     #private;
     private readonly client;
+    readonly overview: OverviewDiscordDirectory;
     constructor(client: Client);
     resolveDiscordUserIdentities(input: DiscordUserIdentityRequest): Promise<{
         guildId: string;
@@ -110,6 +71,7 @@ export interface SupportNotificationInput {
     source: "dashboard_bug" | "dashboard_support" | "dashboard_security" | "discord_command";
 }
 export interface BotControlState {
+    botGuildPermissions?: string[];
     discordCapabilities?: {
         messageContent: boolean;
     };
@@ -134,7 +96,7 @@ export interface DashboardGuildAccessState extends GuildAccessPolicy {
     actorHighestRolePosition: number | null;
     updatedAt: string | null;
 }
-export interface BotControlHandler extends FirstTimeCommandSetupHandler, DashboardActionHandler, ManagedResourceCreateDefaultsControl, ChannelAuditControl, DiscordUserIdentityControl {
+export interface BotControlHandler extends ServerOverviewControl, FirstTimeCommandSetupHandler, DashboardActionHandler, ManagedResourceCreateDefaultsControl, ChannelAuditControl, DiscordUserIdentityControl {
     creatorOnboarding?(input: CreatorOnboardingRequest): Promise<CreatorOnboardingResponse>;
     cleanupOAuthConsumer(input: {
         consumerBindingId: string;
@@ -363,6 +325,8 @@ export declare class BotControlService implements BotControlHandler {
     private readonly supportNotifications?;
     private readonly presenceOwnership?;
     private readonly presenceShardCount?;
+    readonly readServerOverview: NonNullable<ServerOverviewControl["readServerOverview"]>;
+    readonly revokeServerOverviewInvite: NonNullable<ServerOverviewControl["revokeServerOverviewInvite"]>;
     readonly readChannelAuditConfiguration: Required<ChannelAuditControl>["readChannelAuditConfiguration"];
     readonly checkChannelAudit: Required<ChannelAuditControl>["checkChannelAudit"];
     constructor(databaseOrPersistence: DatabasePool | BotControlPersistence, modules: readonly ModuleDefinition[], resources: BotControlGuildResourceDirectory, services: ServiceAccess, privacyExecutor?: PrivacyProviderExecutor, supportNotifications?: {

package/dist/control-server.js

@@ -1,4 +1,8 @@
+import { overviewReadContext } from "./server-overview-profile.js";
 import { discordUserIdentityRequestSchema, } from "@helyx/control-protocol/discord-user-identities";
+import { createServerOverviewControl } from "./server-overview-control.js";
+import { createOverviewDiscordDirectory, } from "./server-overview-discord.js";
+import { registerServerOverviewControlRoutes } from "./server-overview-routes.js";
 import { createDiscordUserIdentityLookup, } from "./discord-user-identities.js";
 import { AuditRepository, GuildAccessPolicyRepository, InstallationRepository, ModuleLoggingPolicyRepository, OptimisticConcurrencyError, PermissionPolicyRepository, withTransaction, } from "@helyx/database";
 import { safeError } from "@helyx/core";
@@ -44,9 +48,11 @@ import { validateDiscordUserSettingSelections, validateDiscordSettingSelections,
 import { configurationValue, guildAccessPolicy, managedResourceDeleteResultSchema, managedResourceDetailSchema, managedResourceFilters, managedResourceObject, managedResourcePageSchema, managedResourceRelationPageSchema, moduleId, mutationContext, permissionState, resourceActionId, resourceCursor, resourceId, snowflake, } from "./control-server-schemas.js";
 export class DiscordGuildResourceDirectory {
     client;
+    overview;
     #identities;
     constructor(client) {
         this.client = client;
+        this.overview = createOverviewDiscordDirectory(client);
         this.#identities = createDiscordUserIdentityLookup(client);
     }
     resolveDiscordUserIdentities(input) {
@@ -107,6 +113,9 @@ export class DiscordGuildResourceDirectory {
                     colour: role.hexColor,
                     position: role.position,
                 })),
+                ...(guild.members?.me
+                    ? { botGuildPermissions: guild.members.me.permissions.toArray() }
+                    : {}),
             };
         }
         catch (error) {
@@ -242,6 +251,9 @@ export class BotControlService {
     #services;
     #privacyProviders;
     #persistence;
+    #overview;
+    readServerOverview;
+    revokeServerOverviewInvite;
     readChannelAuditConfiguration;
     checkChannelAudit;
     constructor(databaseOrPersistence, modules, resources, services, privacyExecutor, supportNotifications, presenceOwnership, presenceShardCount, statusModules) {
@@ -276,6 +288,33 @@ export class BotControlService {
         });
         this.readChannelAuditConfiguration = audit.readChannelAuditConfiguration;
         this.checkChannelAudit = audit.checkChannelAudit;
+        this.#overview = createServerOverviewControl({
+            modules: this.#modules,
+            services: this.#services,
+            permissions: this.#permissions,
+            directory: resources.overview,
+            auditInviteRevoke: async (input) => {
+                await this.#persistence.repositories.audit.append({
+                    guildId: input.guildId,
+                    actorUserId: input.actorUserId,
+                    action: `server.invite.${input.outcome}`,
+                    source: "dashboard",
+                    correlationId: input.correlationId,
+                    targetType: "discord-invite",
+                    targetId: createHash("sha256")
+                        .update(`${input.guildId}:${input.code}`)
+                        .digest("hex"),
+                });
+            },
+            resolveActor: (guildId, actorUserId) => resources.resolveActor(guildId, actorUserId),
+            readGuildPolicy: (guildId) => this.#readGuildAccessPolicy(guildId),
+            listModules: (guildId) => this.#persistence.repositories.installations.listModules(guildId),
+            requireAccessible: (guildId, moduleId) => this.#requireModuleAccessible(guildId, moduleId),
+            context: (guildId, actor) => overviewReadContext(guildId, actor, this.#services),
+        });
+        this.readServerOverview = this.#overview.readServerOverview.bind(this.#overview);
+        this.revokeServerOverviewInvite =
+            this.#overview.revokeServerOverviewInvite.bind(this.#overview);
     }
     async creatorOnboarding(input) {
         return executeCreatorOnboarding(input, {
@@ -994,7 +1033,9 @@ export class BotControlService {
         const declaredIntents = declaration?.creationIntents ?? ["publish"];
         if (!declaredIntents.includes(input.intent))
             throw new DashboardActionValidationError("This creation intent is not declared by the module.");
-        return normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.create(context, input.value, input.intent)), managedResourceColumnKeys(module, input.resourceType));
+        const result = normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.create(context, input.value, input.intent)), managedResourceColumnKeys(module, input.resourceType));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async updateManagedResource(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1005,11 +1046,13 @@ export class BotControlService {
             declaration?.featureId,
             ...resourceFieldFeatureIds(declaration?.fields ?? [], input.value),
         ]);
-        return normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.update(await this.#managedResourceContext(input, module, "update"), {
+        const result = normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.update(await this.#managedResourceContext(input, module, "update"), {
             resourceId: input.resourceId,
             expectedRevision: input.expectedRevision,
             value: input.value,
         })), managedResourceColumnKeys(module, input.resourceType));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async deleteManagedResource(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1017,10 +1060,12 @@ export class BotControlService {
         this.#requireManagedResourceOperation(module, input.resourceType, "delete");
         const declaration = module.manifest.dashboard?.resources?.find(({ id }) => id === input.resourceType);
         await requireDashboardFeatures(this.#services, input.guildId, input.moduleId, [declaration?.featureId]);
-        return managedResourceDeleteResultSchema.parse(await resource.delete(await this.#managedResourceContext(input, module, "delete"), {
+        const result = managedResourceDeleteResultSchema.parse(await resource.delete(await this.#managedResourceContext(input, module, "delete"), {
             resourceId: input.resourceId,
             expectedRevision: input.expectedRevision,
         }));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async executeManagedResourceAction(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1046,6 +1091,7 @@ export class BotControlService {
             expectedRevision: input.expectedRevision,
             value: input.value,
         });
+        this.#overview.invalidate(input.guildId);
         return result === null
             ? null
             : normalizeManagedResourceDetail(managedResourceDetailSchema.parse(result), managedResourceColumnKeys(module, input.resourceType));
@@ -1523,6 +1569,7 @@ export async function createBotControlServer(input) {
         return input.service.setModuleStatus({ ...params, ...body });
     });
     registerDashboardActionRoutes(server, input.service);
+    registerServerOverviewControlRoutes(server, input.service);
     registerChannelAuditRoutes(server, input.service);
     server.get("/v1/guilds/:guildId/modules/:moduleId/resources/:resourceType", async (request) => {
         const params = z

package/dist/creator-invite-service.d.ts

@@ -8,6 +8,13 @@ export declare class DiscordCreatorInviteService implements CreatorInviteService
     private readonly repository;
     private readonly services;
     private readonly module;
+    identifyInvites(input: {
+        guildId: string;
+        codes: readonly string[];
+    }): Promise<readonly {
+        code: string;
+        reference: string;
+    }[]>;
     constructor(client: Client, repository: CreatorInviteRepository, services: ServiceAccess, module: ModuleDefinition | undefined, encryption: string | {
         inviteEncryptionKey: string;
     });

package/dist/creator-invite-service.js

@@ -16,6 +16,23 @@ export class DiscordCreatorInviteService {
     repository;
     services;
     module;
+    async identifyInvites(input) {
+        validateId(input.guildId);
+        if (input.codes.length > 15 ||
+            input.codes.some((code) => !/^[A-Za-z0-9_-]{1,100}$/u.test(code)))
+            throw new CreatorInviteOperationError("unavailable");
+        this.#ownedGuild(input.guildId);
+        if (!(await this.repository.isInstalled()))
+            return [];
+        const requested = new Set(input.codes);
+        const found = [];
+        for (const record of await this.repository.listOwnedForGuild(input.guildId)) {
+            const code = this.#decrypt(record);
+            if (requested.has(code))
+                found.push({ code, reference: record.reference });
+        }
+        return found;
+    }
     #key;
     #rest = null;
     #cleanupCursor;

package/dist/developer-operations-module.js

@@ -27,7 +27,6 @@ export function createDeveloperOperationsModule(input) {
                 "dev.shards",
                 "dev.bot",
                 "dev.modules",
-                "dev.proc",
                 "dev.trivia-data",
                 "dev.leave",
                 "dev.blacklist",
@@ -166,41 +165,6 @@ export function createDeveloperOperationsModule(input) {
                                 });
                             },
                         },
-                        {
-                            name: "proc",
-                            permissionId: "dev.proc",
-                            description: "Show safe process resource and uptime information",
-                            acknowledgement: "immediate-response",
-                            authorization: "self-authorized",
-                            async execute(context) {
-                                if (!(await authorizeDeveloperCommand(context)))
-                                    return;
-                                const memory = process.memoryUsage();
-                                const cpu = process.cpuUsage();
-                                await context.reply({
-                                    ephemeral: true,
-                                    componentsV2: {
-                                        accentColor: 0x2563eb,
-                                        text: [
-                                            {
-                                                content: [
-                                                    "## Process information",
-                                                    `Runtime: ${input.processLabel}`,
-                                                    `Uptime: ${formatDuration(process.uptime())}`,
-                                                    `RSS memory: ${formatBytes(memory.rss)}`,
-                                                    `Heap: ${formatBytes(memory.heapUsed)} used / ${formatBytes(memory.heapTotal)} allocated`,
-                                                    `External memory: ${formatBytes(memory.external)}`,
-                                                    `CPU time: ${formatCpu(cpu.user)} user / ${formatCpu(cpu.system)} system`,
-                                                    `Node: ${safeInlineCode(process.version)}`,
-                                                    `Platform: ${safeInlineCode(`${process.platform}/${process.arch}`)}`,
-                                                    `PID: ${process.pid}`,
-                                                ].join("\n"),
-                                            },
-                                        ],
-                                    },
-                                });
-                            },
-                        },
                         {
                             name: "trivia-data",
                             permissionId: "dev.trivia-data",
@@ -411,25 +375,6 @@ function categoryLabel(category) {
         .join(" ")
         .replace("And", "and");
 }
-function formatBytes(value) {
-    return `${(value / (1024 * 1024)).toFixed(1)} MiB`;
-}
-function formatCpu(microseconds) {
-    return `${(microseconds / 1_000_000).toFixed(2)}s`;
-}
-function formatDuration(seconds) {
-    const total = Math.max(0, Math.floor(seconds));
-    const days = Math.floor(total / 86_400);
-    const hours = Math.floor((total % 86_400) / 3_600);
-    const minutes = Math.floor((total % 3_600) / 60);
-    const remainder = total % 60;
-    return [
-        ...(days > 0 ? [`${days}d`] : []),
-        ...(days > 0 || hours > 0 ? [`${hours}h`] : []),
-        `${minutes}m`,
-        `${remainder}s`,
-    ].join(" ");
-}
 export class WorkerShardHealthProvider {
     #pending = new Map();
     getHealth() {

package/dist/diagnostic-command.js

@@ -22,6 +22,7 @@ const CORE_MODULE_IDS = new Set([
     "helyx.support",
     "helyx.oauth",
     "helyx.privacy",
+    "helyx.process-info",
     "helyx.cloud-connect",
     "helyx.premium-activation",
     "helyx.developer-operations",

package/dist/discord-guild-health.d.ts

@@ -163,8 +163,8 @@ export declare class DiscordGuildHealthInspection implements DiscordGuildHealthI
             resourceValidationValid: boolean | null;
             activationValid: boolean | null;
             catalogueMatches: boolean;
-            requiredCapabilities: readonly ("message-content" | "guild-members")[];
-            missingCapabilities: ("message-content" | "guild-members")[];
+            requiredCapabilities: readonly ("guild-members" | "message-content")[];
+            missingCapabilities: ("guild-members" | "message-content")[];
             missingPermissions: string[];
             healthStatus: "healthy" | "degraded" | "unhealthy";
             healthMessage: string | null;

package/dist/discord-guild-health.js

@@ -8,6 +8,7 @@ const INTERNAL_HELYX_MODULE_IDS = new Set([
     "helyx.management",
     "helyx.permissions",
     "helyx.support",
+    "helyx.process-info",
 ]);
 export function moduleCatalogueMatches(packagedManifest, executableManifest) {
     return (packagedManifest !== null &&

package/dist/events.d.ts

@@ -113,6 +113,7 @@ export declare class DiscordResourceInspection implements DiscordResourceInspect
         userId: string;
         displayName: string | null;
         avatarUrl?: string;
+        isBot?: boolean;
     }[]>;
     searchMembers(input: {
         guildId: string;

package/dist/events.js

@@ -1802,6 +1802,7 @@ export class DiscordResourceInspection {
             const member = members.get(userId) ?? null;
             const cachedUser = this.client.users?.cache?.get(userId);
             const avatarUrl = memberAvatarUrl(member);
+            const isBot = member?.user?.bot ?? cachedUser?.bot;
             return {
                 userId,
                 displayName: member?.displayName ??
@@ -1809,6 +1810,7 @@ export class DiscordResourceInspection {
                     cachedUser?.username ??
                     null,
                 ...(avatarUrl ? { avatarUrl } : {}),
+                ...(typeof isBot === "boolean" ? { isBot } : {}),
             };
         });
     }