@addozhang/dsh-discord 0.1.0

package/lib/gateway/inbound.js

@@ -0,0 +1,186 @@
+/**
+ * Normalized inbound Gateway events. Every Discord dispatch this module
+ * accepts is untrusted wire data: validation failures are values, never
+ * throws, so one malformed payload can never break the dispatch loop. Only
+ * guild-scoped events the adapter understands survive this boundary; DMs and
+ * foreign event shapes are rejected here, before any business logic runs.
+ */
+/** Numeric string of 17-20 digits, the Discord snowflake wire shape. */
+const SNOWFLAKE = /^\d{17,20}$/u;
+/** Validate the snowflake shape of an untrusted string. */
+export function isDiscordSnowflake(value) {
+    return typeof value === 'string' && SNOWFLAKE.test(value);
+}
+/** Gateway dispatch event names the adapter consumes; everything else is rejected. */
+const SUPPORTED_EVENTS = new Set(['MESSAGE_CREATE', 'INTERACTION_CREATE']);
+/** Interaction types the adapter consumes (2=command, 3=component, 4=autocomplete, 5=modal). */
+const SUPPORTED_INTERACTION_TYPES = new Set([2, 3, 4, 5]);
+/**
+ * Detect and strip the adapter's own mention (`<@id>` or `<@!id>`) from
+ * message content. Other users' mentions are left intact; a mention-only
+ * message yields empty text.
+ */
+export function extractBotMention(content, selfUserId) {
+    const pattern = new RegExp(`<@!?${selfUserId}>`, 'gu');
+    const mentioned = pattern.test(content);
+    if (!mentioned)
+        return { mentioned: false, text: content };
+    return { mentioned: true, text: content.replace(pattern, ' ').trim() };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Extract the member's role ids; server-provided, so lenient when absent. */
+function extractRoleIds(payload) {
+    const member = payload['member'];
+    if (!isRecord(member) || !Array.isArray(member['roles']))
+        return [];
+    return member['roles'].filter((role) => typeof role === 'string');
+}
+function asSnowflake(value) {
+    return isDiscordSnowflake(value) ? value : undefined;
+}
+function parseMessage(payload, selfUserId) {
+    // Webhook-authored messages are app-driven surfaces, not member input:
+    // their author object need not carry `bot: true`, and anyone with
+    // Manage Webhooks could otherwise drive prompts through one.
+    if (typeof payload['webhook_id'] === 'string')
+        return { accepted: false, reason: 'bot-authored' };
+    const author = payload['author'];
+    if (!isRecord(author))
+        return { accepted: false, reason: 'malformed-payload' };
+    const authorId = asSnowflake(author['id']);
+    if (authorId === undefined)
+        return { accepted: false, reason: 'malformed-payload' };
+    if (author['bot'] === true || authorId === selfUserId) {
+        return { accepted: false, reason: 'bot-authored' };
+    }
+    const messageId = asSnowflake(payload['id']);
+    const guildId = asSnowflake(payload['guild_id']);
+    const channelId = asSnowflake(payload['channel_id']);
+    if (messageId === undefined || channelId === undefined) {
+        return { accepted: false, reason: 'malformed-payload' };
+    }
+    // A message outside a guild is a DM or foreign surface: reject at the
+    // earliest boundary so it can never reach authorization or DSH.
+    if (guildId === undefined)
+        return { accepted: false, reason: 'non-guild-event' };
+    const content = typeof payload['content'] === 'string' ? payload['content'] : undefined;
+    if (content === undefined)
+        return { accepted: false, reason: 'malformed-payload' };
+    const reference = payload['message_reference'];
+    const repliedToId = isRecord(reference) ? asSnowflake(reference['message_id']) : undefined;
+    if (reference !== undefined && !isRecord(reference)) {
+        return { accepted: false, reason: 'malformed-payload' };
+    }
+    if (isRecord(reference) && reference['message_id'] !== undefined && repliedToId === undefined) {
+        return { accepted: false, reason: 'malformed-payload' };
+    }
+    const stripped = extractBotMention(content, selfUserId);
+    const rawPermissions = typeof (isRecord(payload['member']) ? payload['member'] : {})['permissions'] === 'string'
+        ? payload['member'].permissions
+        : undefined;
+    return {
+        accepted: true,
+        event: {
+            kind: 'message',
+            messageId,
+            guildId,
+            channelId,
+            authorId,
+            roleIds: extractRoleIds(payload),
+            memberPermissions: rawPermissions,
+            content: stripped.text,
+            mentionedBot: stripped.mentioned,
+            repliedToId,
+        },
+    };
+}
+function parseInteraction(payload) {
+    const interactionType = payload['type'];
+    if (typeof interactionType !== 'number' || !SUPPORTED_INTERACTION_TYPES.has(interactionType)) {
+        return { accepted: false, reason: 'unsupported-event' };
+    }
+    const interactionId = asSnowflake(payload['id']);
+    const guildId = asSnowflake(payload['guild_id']);
+    const channelId = asSnowflake(payload['channel_id']);
+    if (interactionId === undefined || guildId === undefined || channelId === undefined) {
+        return { accepted: false, reason: 'malformed-payload' };
+    }
+    const member = payload['member'];
+    const user = payload['user'];
+    const authorId = isRecord(member)
+        ? (isRecord(member['user']) ? asSnowflake(member['user']['id']) : undefined)
+        : isRecord(user)
+            ? asSnowflake(user['id'])
+            : undefined;
+    if (authorId === undefined)
+        return { accepted: false, reason: 'malformed-payload' };
+    const data = payload['data'];
+    if (data !== undefined && !isRecord(data))
+        return { accepted: false, reason: 'malformed-payload' };
+    const table = isRecord(data) ? data : undefined;
+    const commandName = typeof table?.['name'] === 'string' ? table['name'] : undefined;
+    if ((interactionType === 2 || interactionType === 4) && commandName === undefined) {
+        return { accepted: false, reason: 'malformed-payload' };
+    }
+    const memberUser = isRecord(member) && isRecord(member['user']) ? member['user'] : undefined;
+    const wireUser = isRecord(user) ? user : undefined;
+    const rawPermissions = isRecord(member) && typeof member['permissions'] === 'string'
+        ? member['permissions']
+        : undefined;
+    // Component parent message + select values + modal fields (the question
+    // and approval flows need all three; absent for commands/autocomplete).
+    const wireMessage = payload['message'];
+    const componentMessageId = isRecord(wireMessage) ? asSnowflake(wireMessage['id']) : undefined;
+    const selectValues = isRecord(data) && Array.isArray(data['values'])
+        ? data['values'].filter((value) => typeof value === 'string')
+        : [];
+    const modalRows = isRecord(data) && Array.isArray(data['components']) ? data['components'] : [];
+    const modalFields = [];
+    for (const row of modalRows) {
+        if (!isRecord(row) || !Array.isArray(row['components']))
+            continue;
+        for (const field of row['components']) {
+            if (!isRecord(field))
+                continue;
+            if (typeof field['custom_id'] === 'string' && typeof field['value'] === 'string') {
+                modalFields.push({ customId: field['custom_id'], value: field['value'] });
+            }
+        }
+    }
+    return {
+        accepted: true,
+        event: {
+            kind: 'interaction',
+            interactionId,
+            interactionType,
+            guildId,
+            channelId,
+            actorId: authorId,
+            roleIds: extractRoleIds(payload),
+            memberPermissions: rawPermissions,
+            isBot: (memberUser?.['bot'] ?? wireUser?.['bot']) === true,
+            commandName,
+            data: table ?? {},
+            componentMessageId,
+            selectValues,
+            modalFields,
+        },
+    };
+}
+/**
+ * Validate and normalize one untrusted Gateway dispatch. Returns a rejection
+ * value for every unsupported or malformed input and never throws.
+ */
+export function parseGatewayDispatch(dispatch, selfUserId) {
+    if (!isRecord(dispatch) || typeof dispatch['t'] !== 'string' || !SUPPORTED_EVENTS.has(dispatch['t'])) {
+        return { accepted: false, reason: 'unsupported-event' };
+    }
+    const payload = dispatch['d'];
+    if (!isRecord(payload))
+        return { accepted: false, reason: 'malformed-payload' };
+    return dispatch['t'] === 'MESSAGE_CREATE'
+        ? parseMessage(payload, selfUserId)
+        : parseInteraction(payload);
+}

package/lib/gateway/ingress.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The adapter's earliest normalized ingress boundary: dispatch parsing plus
+ * non-guild (DM) rejection. Guild allowlisting and member authorization live
+ * one layer up in `createAuthorizedIngress` (policy/guard.ts), the single
+ * production gate — the former standalone allowlist gate was removed as
+ * redundant (review N8).
+ */
+import { type DiscordSnowflake, type GatewayDispatch, type IngestResult, type NormalizedInteraction, type NormalizedMessage } from './inbound.js';
+export type NormalizedInboundEvent = NormalizedMessage | NormalizedInteraction;
+export { parseGatewayDispatch } from './inbound.js';
+/**
+ * Validate and normalize one dispatch, rejecting non-guild (DM) events at
+ * the earliest boundary. Pure: no allowlist, no delivery.
+ */
+export declare function normalizeInbound(dispatch: GatewayDispatch, selfUserId: DiscordSnowflake): IngestResult;

package/lib/gateway/ingress.js

@@ -0,0 +1,22 @@
+/**
+ * The adapter's earliest normalized ingress boundary: dispatch parsing plus
+ * non-guild (DM) rejection. Guild allowlisting and member authorization live
+ * one layer up in `createAuthorizedIngress` (policy/guard.ts), the single
+ * production gate — the former standalone allowlist gate was removed as
+ * redundant (review N8).
+ */
+import { parseGatewayDispatch, } from './inbound.js';
+export { parseGatewayDispatch } from './inbound.js';
+/**
+ * Validate and normalize one dispatch, rejecting non-guild (DM) events at
+ * the earliest boundary. Pure: no allowlist, no delivery.
+ */
+export function normalizeInbound(dispatch, selfUserId) {
+    const result = parseGatewayDispatch(dispatch, selfUserId);
+    if (!result.accepted)
+        return result;
+    if (result.event.kind === 'message' && typeof result.event.guildId !== 'string') {
+        return { accepted: false, reason: 'non-guild-event' };
+    }
+    return result;
+}

package/lib/i18n.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Bilingual copy for every user-facing Discord string (design 16.25).
+ * The adapter copy language is a plugin setting (`language`: 'zh' | 'en',
+ * default 'zh') — the Host locale itself is not exposed to host-side
+ * plugins (the settings provider is namespace-scoped). `CopyTable` is a
+ * plain object of named members so call sites stay typed and discoverable;
+ * the English table is type-checked against the Chinese one, so a missing
+ * translation is a compile error.
+ */
+export type Language = 'zh' | 'en';
+declare const zh: {
+    bindConfirmButton: string;
+    bindCancelButton: string;
+    bindAdminOnly: string;
+    bindUsage: string;
+    bindWorkspaceGone: string;
+    bindWorkspaceUnknown: string;
+    bindWorkspaceUnavailable: string;
+    bindChannelExists: (title: string, existing: string) => string;
+    bindConfirmPrompt: (title: string) => string;
+    bindCancelled: string;
+    bindChannelFailed: string;
+    bindChannelCreated: (title: string, channelId: string) => string;
+    bindChannelExisting: (title: string, channelId: string) => string;
+    listEmpty: string;
+    listHeader: string;
+    listTruncated: (shown: number, total: number) => string;
+    infoUnboundAllowed: string;
+    infoUnbound: string;
+    infoMemberOnly: string;
+    infoUnknown: string;
+    infoStale: string;
+    infoUnavailable: string;
+    infoRevision: (revision: string, binder: string) => string;
+    infoPath: (path: string) => string;
+    unknownSubcommand: string;
+    stopNotSessionThread: string;
+    stopNothingRunning: string;
+    stopNotOwner: string;
+    stopStopped: string;
+    stopStoppedQueuePreserved: string;
+    stopRejected: string;
+    stopUnknown: string;
+    steerUsage: string;
+    steerNothingRunning: string;
+    steerNotOwner: string;
+    steerQueued: string;
+    steerRejected: string;
+    steerUnknown: string;
+    queueNotSessionThread: string;
+    queueRemoveUsage: string;
+    queueItemNotFound: string;
+    queueRemoved: (summary: string) => string;
+    queueRemoveRejected: string;
+    queueRemoveUnknown: string;
+    queueNoData: string;
+    queueEmpty: string;
+    queueHeader: string;
+    queueRemoveHint: string;
+    forgetOperatorOnly: string;
+    forgetConfirmPrompt: string;
+    forgetConfirmButton: string;
+    forgetDone: string;
+    commandFailed: string;
+    confirmNotOwner: string;
+    submittedAck: string;
+    unresolvedAck: string;
+    expiredControl: string;
+    questionSubmitted: string;
+    questionDenied: string;
+    questionAlreadyResolved: string;
+    questionIncomplete: string;
+    questionInvalid: (reason: string) => string;
+    questionUnresolved: string;
+    questionResolvedElsewhere: string;
+    mainlineThreadConflict: string;
+    mainlineThreadFailed: string;
+    mainlineSessionRejected: string;
+    mainlineSessionUnknown: string;
+    mainlinePromptRejected: string;
+    mainlinePromptUnknown: string;
+    continuationRejected: string;
+    continuationUnknown: string;
+    unboundNoticeAdministrator: string;
+    unboundNoticeMember: string;
+    interruptedMarker: string;
+    approvalRequired: (label: string) => string;
+};
+export type CopyTable = typeof zh;
+/** Discord-visible copy for the configured language. */
+export declare function createCopy(language: Language): CopyTable;
+export {};

package/lib/i18n.js

@@ -0,0 +1,180 @@
+/**
+ * Bilingual copy for every user-facing Discord string (design 16.25).
+ * The adapter copy language is a plugin setting (`language`: 'zh' | 'en',
+ * default 'zh') — the Host locale itself is not exposed to host-side
+ * plugins (the settings provider is namespace-scoped). `CopyTable` is a
+ * plain object of named members so call sites stay typed and discoverable;
+ * the English table is type-checked against the Chinese one, so a missing
+ * translation is a compile error.
+ */
+const zh = {
+    // ── /project bind ────────────────────────────────────────────────────
+    bindConfirmButton: '确认绑定',
+    bindCancelButton: '取消',
+    bindAdminOnly: '⚠️ 只有工作区管理员可以绑定频道。',
+    bindUsage: '💡 用法：/project bind workspace:<从候选中选择>',
+    bindWorkspaceGone: '⚠️ 该工作区已不存在，请用 /project bind 的候选重新选择。',
+    bindWorkspaceUnknown: '⚠️ 工作区目录未在限时内确认（结果未知），请稍后重试。',
+    bindWorkspaceUnavailable: '⚠️ 工作区目录暂时不可用，请稍后重试。',
+    bindChannelExists: (title, existing) => `工作区「${title}」的频道已存在于：<#${existing}>`,
+    bindConfirmPrompt: (title) => `将为工作区「${title}」创建专属频道（DeepSeek Harness 分类下）？`,
+    bindCancelled: '已取消，未创建频道。',
+    bindChannelFailed: '⚠️ 频道创建失败，请稍后重试。',
+    bindChannelCreated: (title, channelId) => `💡 已为工作区「${title}」创建频道：<#${channelId}>`,
+    bindChannelExisting: (title, channelId) => `💡 工作区「${title}」的频道已存在于：<#${channelId}>`,
+    // ── /project list / info ─────────────────────────────────────────────
+    listEmpty: '（没有已注册的工作区）',
+    listHeader: '**可用工作区**',
+    listTruncated: (shown, total) => `\n（共 ${String(total)} 个，仅列出前 ${String(shown)} 个）`,
+    infoUnboundAllowed: '此频道未绑定工作区；请到工作区的专属频道中使用（/project bind 可创建）。',
+    infoUnbound: '⚠️ 此频道未绑定工作区。',
+    infoMemberOnly: '⚠️ 只有成员可以查看此频道的绑定。',
+    infoUnknown: '⚠️ 工作区目录未在限时内确认（结果未知），请稍后重试。',
+    infoStale: '⚠️ 绑定的工作区已不存在；请用 /project bind 重新选择。',
+    infoUnavailable: '⚠️ 无法读取工作区目录，请稍后重试。',
+    infoRevision: (revision, binder) => `修订 ${revision}（由 <@${binder}> 绑定）`,
+    infoPath: (path) => `路径：\`${path}\``,
+    unknownSubcommand: '💡 未知子命令。',
+    // ── /stop /steer /queue ──────────────────────────────────────────────
+    stopNotSessionThread: '⚠️ 此频道不是适配器拥有的会话线程。',
+    stopNothingRunning: '此线程当前没有可停止的运行中任务。',
+    stopNotOwner: '⚠️ 当前运行中的任务不是由此线程提交的，无法停止。',
+    stopStopped: '🛑 已停止。',
+    stopStoppedQueuePreserved: '🛑 已停止；队列中的待处理消息已保留。',
+    stopRejected: '⚠️ DSH 拒绝了停止请求。',
+    stopUnknown: '⚠️ 停止结果未知，请到 DSH Web 确认。',
+    steerUsage: '💡 用法：/steer prompt:<插话内容>',
+    steerNothingRunning: '此线程当前没有运行中的任务可插话。',
+    steerNotOwner: '⚠️ 当前任务不是由此线程提交的，无法插话。',
+    steerQueued: '↪️ 已插话。',
+    steerRejected: '⚠️ DSH 拒绝了插话。',
+    steerUnknown: '⚠️ 插话结果未知。',
+    queueNotSessionThread: '⚠️ 此频道不是适配器拥有的会话线程。',
+    queueRemoveUsage: '💡 用法：/queue remove item:</queue list 中的编号>',
+    queueItemNotFound: '未找到该队列项；请先运行 /queue list 获取最新编号。',
+    queueRemoved: (summary) => `⏳ 已移除：${summary}`,
+    queueRemoveRejected: '⚠️ DSH 拒绝了移除请求（该项可能已被处理）。',
+    queueRemoveUnknown: '⚠️ 移除结果未知；请用 /queue list 确认后再试。',
+    queueNoData: '⚠️ 暂无队列数据（进程可能刚重启）；等待会话活动后会自动同步。',
+    queueEmpty: '⏳ （队列为空）',
+    queueHeader: '⏳ **队列**',
+    queueRemoveHint: '💡 用 `/queue remove <编号>` 移除。',
+    // ── guild forget ─────────────────────────────────────────────────────
+    forgetOperatorOnly: '⚠️ 只有 Host 操作员可以忘记 Guild。',
+    forgetConfirmPrompt: '⚠️ 将删除本 Guild 的全部适配器记录（绑定/意图；DSH 工作区与 Session 不受影响）。确认？',
+    forgetConfirmButton: '确认忘记',
+    forgetDone: '💡 已忘记本 Guild：适配器记录（绑定/意图）已删除；DSH 工作区与 Session 未受影响。',
+    // ── interaction failures / denials ───────────────────────────────────
+    commandFailed: '⚠️ 命令处理失败，请稍后重试。',
+    confirmNotOwner: '⚠️ 此确认不属于你。',
+    submittedAck: '💡 已提交你的选择。',
+    unresolvedAck: '⚠️ 应答结果未知；DSH 未确认，请勿重复点击。',
+    expiredControl: '⚠️ 此控件已过期或已失效；请重新运行对应命令。',
+    // ── question settle copies ───────────────────────────────────────────
+    questionSubmitted: '💡 回答已提交。',
+    questionDenied: '⚠️ 此问题不属于你。',
+    questionAlreadyResolved: '💡 该问题已被处理。',
+    questionIncomplete: '💡 还有问题未回答；请完成后再提交。',
+    questionInvalid: (reason) => `⚠️ 回答无效：${reason}`,
+    questionUnresolved: '⚠️ 应答结果未知；DSH 未确认。',
+    questionResolvedElsewhere: '💡 该问题已被其他客户端处理。',
+    // ── mainline failure copies (per outcome) ────────────────────────────
+    mainlineThreadConflict: '⚠️ 这条消息已被用于另一个会话任务，无法重复创建线程。',
+    mainlineThreadFailed: '⚠️ 线程创建失败，请稍后重试。',
+    mainlineSessionRejected: '⚠️ DSH 拒绝了会话创建（工作区可能已失效）；请稍后重试或重新 /project bind。',
+    mainlineSessionUnknown: '⚠️ 会话创建结果未知；请到 DSH Web 确认后再重试，不会自动重复创建。',
+    mainlinePromptRejected: '⚠️ DSH 拒绝了任务提交。',
+    mainlinePromptUnknown: '⚠️ 任务提交结果未知；为避免重复执行不会自动重发，请确认后重试。',
+    continuationRejected: '⚠️ 消息提交被 DSH 拒绝。',
+    continuationUnknown: '⚠️ 消息提交结果未知；不会自动重发，请确认后重试。',
+    // ── unbound-channel mention affordance ───────────────────────────────
+    unboundNoticeAdministrator: '💡 此频道未绑定工作区。工作区管理员可运行 `/project bind` 创建并绑定项目频道。',
+    unboundNoticeMember: '💡 此频道未绑定工作区；请工作区管理员运行 `/project bind`。',
+    // ── stream renderer ──────────────────────────────────────────────────
+    interruptedMarker: '*（已被中断）*',
+    // ── approval / question cards ────────────────────────────────────────
+    approvalRequired: (label) => `Approval required — ${label}`,
+};
+const en = {
+    bindConfirmButton: 'Confirm bind',
+    bindCancelButton: 'Cancel',
+    bindAdminOnly: '⚠️ Only workspace administrators can bind channels.',
+    bindUsage: '💡 Usage: /project bind workspace:<pick from candidates>',
+    bindWorkspaceGone: '⚠️ That workspace no longer exists; pick again from /project bind candidates.',
+    bindWorkspaceUnknown: '⚠️ The workspace directory could not be confirmed in time (unknown); try again later.',
+    bindWorkspaceUnavailable: '⚠️ The workspace directory is temporarily unavailable; try again later.',
+    bindChannelExists: (title, existing) => `A channel for workspace "${title}" already exists at <#${existing}>`,
+    bindConfirmPrompt: title => `Create a dedicated channel for workspace "${title}" (under the DeepSeek Harness category)?`,
+    bindCancelled: 'Cancelled — no channel was created.',
+    bindChannelFailed: '⚠️ Channel creation failed; try again later.',
+    bindChannelCreated: (title, channelId) => `💡 Created a channel for workspace "${title}": <#${channelId}>`,
+    bindChannelExisting: (title, channelId) => `💡 Workspace "${title}" already has a channel: <#${channelId}>`,
+    listEmpty: '(no registered workspaces)',
+    listHeader: '**Available workspaces**',
+    listTruncated: (shown, total) => `\n(showing ${String(shown)} of ${String(total)})`,
+    infoUnboundAllowed: 'This channel is not bound to a workspace; use the workspace home channel (/project bind creates one).',
+    infoUnbound: '⚠️ This channel is not bound to a workspace.',
+    infoMemberOnly: '⚠️ Only members can view this channel binding.',
+    infoUnknown: '⚠️ The workspace directory could not be confirmed in time (unknown); try again later.',
+    infoStale: '⚠️ The bound workspace no longer exists; re-run /project bind.',
+    infoUnavailable: '⚠️ The workspace directory is temporarily unavailable; try again later.',
+    infoRevision: (revision, binder) => `Revision ${revision} (bound by <@${binder}>)`,
+    infoPath: path => `Path: \`${path}\``,
+    unknownSubcommand: '💡 Unknown subcommand.',
+    stopNotSessionThread: '⚠️ This channel is not an adapter-owned session thread.',
+    stopNothingRunning: 'This thread has no running task to stop.',
+    stopNotOwner: '⚠️ The running task was not submitted from this thread and cannot be stopped here.',
+    stopStopped: '🛑 Stopped.',
+    stopStoppedQueuePreserved: '🛑 Stopped; queued messages are preserved.',
+    stopRejected: '⚠️ DSH rejected the stop request.',
+    stopUnknown: '⚠️ Stop outcome unknown; check the DSH web console.',
+    steerUsage: '💡 Usage: /steer prompt:<steering text>',
+    steerNothingRunning: 'This thread has no running task to steer.',
+    steerNotOwner: '⚠️ The running task was not submitted from this thread and cannot be steered here.',
+    steerQueued: '↪️ Steering delivered.',
+    steerRejected: '⚠️ DSH rejected the steering.',
+    steerUnknown: '⚠️ Steering outcome unknown.',
+    queueNotSessionThread: '⚠️ This channel is not an adapter-owned session thread.',
+    queueRemoveUsage: '💡 Usage: /queue remove item:<position from /queue list>',
+    queueItemNotFound: 'Queue item not found; run /queue list for fresh positions.',
+    queueRemoved: summary => `⏳ Removed: ${summary}`,
+    queueRemoveRejected: '⚠️ DSH rejected the removal (the item may already be handled).',
+    queueRemoveUnknown: '⚠️ Removal outcome unknown; verify with /queue list and retry.',
+    queueNoData: '⚠️ No queue data yet (the process may have just restarted); it syncs after session activity.',
+    queueEmpty: '⏳ (queue is empty)',
+    queueHeader: '⏳ **Queue**',
+    queueRemoveHint: '💡 Use `/queue remove <position>` to remove.',
+    forgetOperatorOnly: '⚠️ Only Host operators can forget a Guild.',
+    forgetConfirmPrompt: '⚠️ This deletes every adapter-owned record for this Guild (bindings/intents; DSH workspaces and sessions are untouched). Continue?',
+    forgetConfirmButton: 'Confirm forget',
+    forgetDone: '💡 Guild forgotten: adapter records (bindings/intents) are deleted; DSH workspaces and sessions are untouched.',
+    commandFailed: '⚠️ Command handling failed; try again later.',
+    confirmNotOwner: '⚠️ This confirmation is not yours.',
+    submittedAck: '💡 Your choice has been submitted.',
+    unresolvedAck: '⚠️ Outcome unknown; DSH did not confirm — do not repeat the click.',
+    expiredControl: '⚠️ This control has expired or is no longer valid; run the command again.',
+    questionSubmitted: '💡 Answers submitted.',
+    questionDenied: '⚠️ This question is not yours.',
+    questionAlreadyResolved: '💡 This question has already been handled.',
+    questionIncomplete: '💡 Some questions are unanswered; complete them before submitting.',
+    questionInvalid: reason => `⚠️ Invalid answer: ${reason}`,
+    questionUnresolved: '⚠️ Outcome unknown; DSH did not confirm.',
+    questionResolvedElsewhere: '💡 This question was already handled by another client.',
+    mainlineThreadConflict: '⚠️ This message was already used for another session task; the thread cannot be recreated.',
+    mainlineThreadFailed: '⚠️ Thread creation failed; try again later.',
+    mainlineSessionRejected: '⚠️ DSH rejected the session creation (the workspace may be stale); try again later or re-run /project bind.',
+    mainlineSessionUnknown: '⚠️ Session creation outcome unknown; confirm on the DSH web console before retrying. It will not be resubmitted automatically.',
+    mainlinePromptRejected: '⚠️ DSH rejected the task submission.',
+    mainlinePromptUnknown: '⚠️ Task submission outcome unknown; it will not be resent automatically to avoid double execution. Confirm and retry.',
+    continuationRejected: '⚠️ The message submission was rejected by DSH.',
+    continuationUnknown: '⚠️ Message submission outcome unknown; it will not be resent automatically. Confirm and retry.',
+    unboundNoticeAdministrator: '💡 This channel is not bound to a workspace. A workspace administrator can run `/project bind` to create and bind the project channel.',
+    unboundNoticeMember: '💡 This channel is not bound to a workspace; ask a workspace administrator to run `/project bind`.',
+    interruptedMarker: '*(interrupted)*',
+    // ── approval / question cards ────────────────────────────────────────
+    approvalRequired: label => `Approval required — ${label}`,
+};
+/** Discord-visible copy for the configured language. */
+export function createCopy(language) {
+    return language === 'en' ? en : zh;
+}

package/lib/index.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type z from '@deepseek-ai/schemastery';
+import { type DiscordSettings } from './settings.js';
+/** Stable Cordis plugin name for diagnostics. */
+export declare const name = "dsh-discord";
+/** Host services required by the complete embedded adapter. */
+export declare const inject: string[];
+export type Config = DiscordSettings;
+export declare const Config: z<Config>;
+/**
+ * Mount the embedded Discord adapter. Composition of the runtime path
+ * (Gateway → ingress → command/mention dispatch → Discord REST, plus the
+ * reconciliation sweeps) lives in `src/compose.ts` and is started from here.
+ */
+export declare function apply(ctx: Context, config?: Config): void;
+export { DEFAULT_DISCORD_SETTINGS, DISCORD_SETTINGS_NAMESPACE, DiscordSettingsSchema, normalizeDiscordSettings, validateDiscordSettings, } from './settings.js';
+export { DISCORD_BOT_TOKEN_REF, describeDiscordCredential, resolveDiscordBotToken, } from './credential.js';