dsh-qqchat 0.2.0

package/lib/types.d.ts

@@ -0,0 +1,416 @@
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+export type ChatType = 'c2c' | 'group';
+export type MessageDirection = 'inbound' | 'outbound';
+export type MemoryScopeType = 'group' | 'member';
+export type MemoryDocType = 'profile' | 'summary' | 'daily' | 'memory' | 'pattern';
+export type ProfileEntryType = 'name' | 'address' | 'pronoun' | 'background' | 'preference' | 'note';
+export interface ProfileEntry {
+    type: ProfileEntryType;
+    text: string;
+    ts: number;
+}
+export interface DailyEntry {
+    date: string;
+    note: string;
+}
+export type ReplyFormat = 'smart' | 'markdown' | 'compat';
+export type GroupReceiveMode = 'auto' | 'mention' | 'silent';
+export type GatewayStatus = 'offline' | 'connecting' | 'online' | 'error';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type QQMediaKind = 'image' | 'audio' | 'video' | 'voice' | 'file';
+export interface QQAttachmentInput {
+    sourceUrl?: string;
+    filename: string;
+    contentType?: string;
+    size?: number;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    platformFileId?: string;
+    quoted?: boolean;
+    kind?: QQMediaKind;
+    attachmentId?: string;
+}
+export interface QQQuoteInput {
+    messageId?: string;
+    senderId?: string;
+    senderName?: string;
+    text: string;
+    attachments: QQAttachmentInput[];
+}
+export interface StoredAttachmentSummary {
+    id: string;
+    kind: QQMediaKind;
+    filename: string;
+    contentType?: string;
+    sizeBytes: number;
+    quoted: boolean;
+    /** Platform file identity used to preserve one-to-one input mapping. */
+    sourceFileId?: string;
+    /** Position in the original QQ attachment list; used only as a lossless fallback. */
+    sourceIndex?: number;
+    localPath?: string;
+    imageRef?: ImageAttachmentRef;
+}
+export interface QQChatRuntimeSettings {
+    memoryEnabled: boolean;
+    groupReceiveMode: GroupReceiveMode;
+    groupReplyFormat: ReplyFormat;
+    directReplyFormat: ReplyFormat;
+    directStreamingEnabled: boolean;
+    groupMembersCanUseTools: boolean;
+    groupMembersCanReceiveMedia: boolean;
+    groupMembersCanReadMedia: boolean;
+    ownerUserId: string;
+}
+export interface QQChatRuntimeSettingsPatch {
+    memoryEnabled?: boolean;
+    groupReceiveMode?: GroupReceiveMode;
+    groupReplyFormat?: ReplyFormat;
+    directReplyFormat?: ReplyFormat;
+    directStreamingEnabled?: boolean;
+    groupMembersCanUseTools?: boolean;
+    groupMembersCanReceiveMedia?: boolean;
+    groupMembersCanReadMedia?: boolean;
+    ownerUserId?: string;
+}
+export interface PluginLogEntry {
+    id: number;
+    time: number;
+    level: LogLevel;
+    message: string;
+}
+export interface LoggerLike {
+    error?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+    debug?: (...args: unknown[]) => void;
+}
+export interface QQChatConfigInput {
+    dataDir?: string;
+    source?: string;
+    sandbox?: boolean;
+    agentPreset?: string;
+    provider?: string;
+    model?: string;
+    maxTokens?: number;
+    groupChatEnabled?: boolean;
+    groupRequiresAt?: boolean;
+    groupReadEnabled?: boolean;
+    replyFormat?: ReplyFormat;
+    recentGroupMessages?: number;
+    reflectionIdleMs?: number;
+    reflectionBatchSize?: number;
+    reflectionMaxMessages?: number;
+    memoryMaxTokens?: number;
+    memoryCompressionMaxTokens?: number;
+}
+export interface QQChatConfig {
+    readonly dataDir: string;
+    readonly source: string;
+    readonly sandbox: boolean;
+    readonly agentPreset?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly maxTokens?: number;
+    readonly groupChatEnabled: boolean;
+    readonly groupRequiresAt: boolean;
+    readonly groupReadEnabled: boolean;
+    readonly replyFormat: ReplyFormat;
+    readonly recentGroupMessages: number;
+    readonly reflectionIdleMs: number;
+    readonly reflectionBatchSize: number;
+    readonly reflectionMaxMessages: number;
+    readonly memoryMaxTokens: number;
+    readonly memoryCompressionMaxTokens: number;
+}
+export interface AccountRow {
+    id: number;
+    app_id: string;
+    app_secret: string;
+    bot_user_id: string | null;
+    enabled: 0 | 1;
+    sandbox: 0 | 1;
+    gateway_status: GatewayStatus;
+    gateway_last_error: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface PublicAccountRow extends Omit<AccountRow, 'app_secret'> {
+}
+export interface AuthTaskRow {
+    task_id: string;
+    aes_key: string;
+    expires_at: number;
+}
+export interface GroupRow {
+    id: number;
+    account_id: number;
+    platform_group_id: string;
+    name: string | null;
+    enabled: 0 | 1;
+    read_enabled: 0 | 1;
+    dsh_session_id: string | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface GroupListRow extends GroupRow {
+    last_message_at: number | null;
+    member_count: number;
+    message_count: number;
+}
+export interface DirectChatListRow extends MemberRow {
+    last_message_at: number | null;
+    message_count: number;
+}
+export interface ChatTargetRow {
+    chatType: ChatType;
+    rowId: number;
+    accountId: number;
+    platformId: string;
+    displayName: string;
+    dshSessionId: string | null;
+    lastMessageAt: number | null;
+    messageCount: number;
+}
+export interface GroupDefaults {
+    name?: string;
+    enabled?: boolean;
+    readEnabled?: boolean;
+}
+export interface GroupPatch {
+    name?: string;
+    enabled?: boolean;
+    readEnabled?: boolean;
+}
+export interface MemberRow {
+    id: number;
+    account_id: number;
+    platform_user_id: string;
+    display_name: string | null;
+    dsh_session_id: string | null;
+    first_seen_at: number;
+    last_seen_at: number;
+}
+export interface GroupMemberRow {
+    id: number;
+    platform_user_id: string;
+    global_display_name: string | null;
+    display_name: string | null;
+    first_seen_at: number;
+    last_seen_at: number;
+    aliases_json: string | null;
+    nicknames_json: string | null;
+    message_count: number;
+}
+export interface MessageRow {
+    id: number;
+    account_id: number;
+    platform_message_id: string | null;
+    chat_type: ChatType;
+    group_id: number | null;
+    member_id: number | null;
+    direction: MessageDirection;
+    content: string;
+    quoted_text: string | null;
+    mentioned: 0 | 1;
+    created_at: number;
+    raw_json: string | null;
+    attachments_json: string | null;
+    quote_json: string | null;
+    platform_user_id?: string | null;
+    display_name?: string | null;
+}
+export interface InsertMessageInput {
+    accountId: number;
+    platformMessageId?: string;
+    chatType: ChatType;
+    groupId?: number;
+    memberId?: number;
+    direction: MessageDirection;
+    content: string;
+    quotedText?: string;
+    mentioned?: boolean;
+    createdAt?: number;
+    raw?: unknown;
+    attachments?: StoredAttachmentSummary[];
+    quote?: QQQuoteInput;
+}
+export interface ReflectionStateRow {
+    group_id: number;
+    last_message_id: number;
+    last_reflected_at: number | null;
+}
+export interface OutboxRow {
+    id: number;
+    account_id: number;
+    chat_type: ChatType;
+    target_id: string;
+    content: string;
+    status: 'pending' | 'sent' | 'failed';
+    scheduled_at: number;
+    sent_at: number | null;
+    error: string | null;
+}
+export type MemoryDocuments = Partial<Record<MemoryDocType, string>>;
+export interface QQChatDisplayEvent {
+    messageId: string;
+    chatType: ChatType;
+    chatId: string;
+    direction: MessageDirection;
+    senderId: string;
+    senderName: string;
+    isOwner?: boolean;
+    content: string;
+    quotedText: string;
+    mentioned: boolean;
+    createdAt: number;
+    sessionId?: string;
+    attachments?: StoredAttachmentSummary[];
+    quote?: QQQuoteInput;
+}
+export interface QQNormalizedMessage {
+    platform: 'qq';
+    accountId: number;
+    chatType: ChatType;
+    chatId: string;
+    senderId: string;
+    senderName: string;
+    groupOpenid?: string;
+    messageId: string;
+    msgIdx?: string;
+    refMsgIdx?: string;
+    text: string;
+    quotedText: string;
+    attachments: QQAttachmentInput[];
+    quote?: QQQuoteInput;
+    mentioned: boolean;
+    botMentionId: string;
+    raw: Record<string, unknown>;
+}
+export interface QQQuoteIndexInput {
+    accountId: number;
+    chatType: ChatType;
+    chatId: string;
+    msgIdx: string;
+    platformMessageId?: string;
+    senderId: string;
+    senderName?: string;
+    content: string;
+    attachments: QQAttachmentInput[];
+    createdAt: number;
+    expiresAt: number;
+}
+export interface QQQuoteIndexRow extends QQQuoteIndexInput {
+    id: number;
+}
+export interface QQAuthor {
+    user_openid?: string;
+    member_openid?: string;
+    id?: string;
+    username?: string;
+    nickname?: string;
+    [key: string]: unknown;
+}
+export interface QQMention {
+    bot?: boolean;
+    is_you?: boolean;
+    id?: string;
+    user_openid?: string;
+    member_openid?: string;
+    openid?: string;
+    [key: string]: unknown;
+}
+export interface QQDispatchData extends Record<string, unknown> {
+    id?: string;
+    content?: string;
+    group_openid?: string;
+    author?: QQAuthor;
+    mentions?: QQMention[];
+    message_reference?: Record<string, unknown>;
+    reference?: Record<string, unknown>;
+    quote?: Record<string, unknown>;
+    msg_elements?: Array<Record<string, unknown>>;
+    message_scene?: {
+        ext?: unknown[];
+    };
+    attachments?: Array<Record<string, unknown>>;
+}
+export interface QQAccessTokenPayload {
+    access_token?: string;
+    expires_in?: number | string;
+    [key: string]: unknown;
+}
+export interface QQGatewayPayload {
+    url?: string;
+    [key: string]: unknown;
+}
+export interface QQBindCreatePayload {
+    retcode?: number;
+    msg?: string;
+    data?: {
+        task_id?: string;
+    };
+}
+export interface QQBindPollPayload {
+    retcode?: number;
+    msg?: string;
+    data?: {
+        status?: number;
+        bot_appid?: string | number;
+        bot_encrypt_secret?: string;
+    };
+}
+export interface QQGatewayFrame {
+    op: number;
+    s?: number;
+    t?: string;
+    d?: Record<string, unknown> & {
+        heartbeat_interval?: number;
+        session_id?: string;
+        user?: {
+            id?: string;
+            openid?: string;
+        };
+    };
+}
+export interface QQSendOptions {
+    group?: boolean;
+    messageId?: string | null;
+    format?: ReplyFormat;
+}
+export interface ModelRoute {
+    provider: string;
+    model: string;
+    sessionId?: string;
+}
+export interface PendingReply {
+    text: string;
+    onTextDelta?: (delta: string) => void;
+}
+export interface ReflectionGroupUpdate {
+    profile?: unknown;
+    summary?: unknown;
+    daily?: unknown;
+    memory?: unknown;
+}
+export interface ReflectionMemberUpdate {
+    senderId?: unknown;
+    profile?: unknown;
+    pattern?: unknown;
+    summary?: unknown;
+    memory?: unknown;
+    nicknames?: unknown;
+}
+export interface ReflectionPayload {
+    group?: ReflectionGroupUpdate;
+    members?: ReflectionMemberUpdate[];
+}
+export interface MemoryViewMember extends GroupMemberRow {
+    memory: MemoryDocuments;
+}
+export interface MemoryView {
+    group: GroupRow;
+    groupMemory: MemoryDocuments;
+    members: MemoryViewMember[];
+}

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "dsh-qqchat",
+  "version": "0.2.0",
+  "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "client-src",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "docs",
+    "scripts",
+    "tsconfig.json",
+    "tsconfig.build.json",
+    "tsconfig.client.json"
+  ],
+  "scripts": {
+    "clean": "node -e \"const fs=require('node:fs');fs.rmSync('lib',{recursive:true,force:true});fs.rmSync('.client-build',{recursive:true,force:true})\"",
+    "build:host": "tsc -p tsconfig.build.json",
+    "build:client": "tsc -p tsconfig.client.json && node scripts/wrap-client.mjs",
+    "build": "npm run clean && npm run build:host && npm run build:client",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsx --test tests/*.test.ts",
+    "check": "npm run typecheck && npm test && npm run build",
+    "prepublishOnly": "npm run check",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.8"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.8",
+    "@types/node": "^22.18.0",
+    "@types/qrcode": "^1.5.5",
+    "@types/react": "^19.1.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/Coffeiz/dsh-qqchat.git"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "qq",
+    "qqbot",
+    "chat",
+    "memory",
+    "cordis",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/wrap-client.mjs

@@ -0,0 +1,20 @@
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { relative, resolve, sep } from 'node:path'
+
+const root = resolve('.client-build')
+const names = (await readdir(root, { recursive: true }))
+  .filter(name => name.endsWith('.cjs'))
+  .sort()
+
+const modules = []
+for (const name of names) {
+  const absolute = resolve(root, name)
+  const id = `./${relative(root, absolute).split(sep).join('/')}`
+  const body = await readFile(absolute, 'utf8')
+  modules.push(`${JSON.stringify(id)}: function(module, exports, require) {\n${body}\n}`)
+}
+
+const wrapped = `window.__ModuleLoader__.load({ id: "dsh-qqchat", factory: (require) => {\nvar __qqModules = {\n${modules.join(',\n')}\n};\nvar __qqCache = Object.create(null);\nfunction __qqRequire(id) {\n  var factory = __qqModules[id];\n  if (!factory) return require(id);\n  var cached = __qqCache[id];\n  if (cached) return cached.exports;\n  var module = { exports: {} };\n  __qqCache[id] = module;\n  factory(module, module.exports, __qqRequire);\n  return module.exports;\n}\nreturn __qqRequire("./plugin.cjs");\n} })\n`
+await mkdir('lib', { recursive: true })
+await writeFile('lib/client.js', wrapped, 'utf8')
+await rm('.client-build', { recursive: true, force: true })

package/src/commands/dispatch.ts

@@ -0,0 +1,75 @@
+import type { Agent } from '@deepseek-ai/dsh-agent'
+import type { CommandDescriptor, CommandExecution, CommandRuntime } from '@deepseek-ai/dsh-commands'
+
+export interface QQCommandReply {
+  handled: boolean
+  text?: string
+}
+
+export interface QQCommandScope {
+  chatType: 'group' | 'c2c'
+  isOwner: boolean
+}
+
+const READ_ONLY_GROUP_COMMANDS = new Set([
+  'help', 'qqhelp', 'qqcommands', 'qqping', 'qqversion', 'qqstatus',
+])
+
+/** Normalize a QQ command that may be prefixed by the bot mention. */
+export function qqCommandText(text: string, mentioned: boolean): string | undefined {
+  const input = text.trim()
+  if (/^\/[a-z][a-z0-9_-]*(?:\s|$)/u.test(input)) return input
+  if (!mentioned) return undefined
+  const prefixed = /^(?:<@!?[^>]+>|@[^\s]+)\s*(\/[a-z][a-z0-9_-]*(?:\s|$).*)$/su.exec(input)
+  return prefixed?.[1]?.trim()
+}
+
+/** Return the command name from a complete slash-command line. */
+export function slashCommandName(input: string): string | undefined {
+  const match = /^\/([a-z][a-z0-9_-]*)(?=\s|$)/u.exec(input)
+  return match?.[1]
+}
+
+function renderCommandList(commands: readonly CommandDescriptor[]): string {
+  if (commands.length === 0) return '当前 DSH 没有可用命令。'
+  return ['可用 DSH 命令：', ...commands.map(command => {
+    const hint = command.input?.hint ? ` ${command.input.hint}` : ''
+    return `/${command.name}${hint} — ${command.description}`
+  })].join('\n')
+}
+
+/** Dispatch one QQ slash command through DSH's native command registry. */
+export async function dispatchQQCommand(
+  commands: CommandRuntime,
+  agent: Agent,
+  input: string,
+  scope: QQCommandScope = { chatType: 'c2c', isOwner: true },
+): Promise<QQCommandReply> {
+  if (!input.startsWith('/')) return { handled: false }
+
+  const name = slashCommandName(input)
+  if (name === undefined) return { handled: true, text: '命令格式无效。发送 /help 查看可用命令。' }
+
+  // Native commands bypass the tools/pre-execute seam. Keep group control
+  // commands owner-only so they cannot change or stop a shared group Session.
+  if (scope.chatType === 'group' && !scope.isOwner && !READ_ONLY_GROUP_COMMANDS.has(name)) {
+    return { handled: true, text: '普通群成员只能使用查询类命令。' }
+  }
+
+  // QQ has no browser download channel for the Web-only command.
+  if (name === 'export' && commands.find(agent, name) !== undefined) {
+    return { handled: true, text: '/export 仅支持 DSH Web 下载会话日志，QQ 中暂不支持。' }
+  }
+
+  const execution: CommandExecution | undefined = await commands.execute(
+    agent,
+    input,
+    [],
+    new AbortController().signal,
+  )
+  if (execution === undefined) {
+    return { handled: true, text: `未知或格式无效的命令：/${name}\n\n${renderCommandList(commands.list(agent))}` }
+  }
+
+  return { handled: true, text: execution.result.text?.trim() || `/${name} 已执行。` }
+}

package/src/config.ts

@@ -0,0 +1,70 @@
+import { homedir } from 'node:os'
+import { join, resolve } from 'node:path'
+import type { GroupReceiveMode, QQChatConfig, QQChatConfigInput, QQChatRuntimeSettings, ReplyFormat } from './types.js'
+
+const DEFAULT_CONFIG = Object.freeze({
+  source: 'dsh-qqchat',
+  sandbox: false,
+  groupChatEnabled: true,
+  groupRequiresAt: true,
+  groupReadEnabled: true,
+  replyFormat: 'smart' as ReplyFormat,
+  recentGroupMessages: 40,
+  reflectionIdleMs: 120_000,
+  reflectionBatchSize: 20,
+  reflectionMaxMessages: 80,
+  memoryMaxTokens: 1400,
+  memoryCompressionMaxTokens: 15000,
+})
+
+export function resolveConfig(input: QQChatConfigInput = {}): QQChatConfig {
+  const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+  const replyFormat: ReplyFormat = ['smart', 'markdown', 'compat'].includes(input.replyFormat ?? '')
+    ? input.replyFormat as ReplyFormat
+    : DEFAULT_CONFIG.replyFormat
+
+  return Object.freeze({
+    dataDir: resolve(input.dataDir || join(home, 'plugins', 'dsh-qqchat')),
+    source: input.source || DEFAULT_CONFIG.source,
+    sandbox: input.sandbox === true,
+    agentPreset: input.agentPreset,
+    provider: input.provider,
+    model: input.model,
+    maxTokens: positiveIntOrUndefined(input.maxTokens),
+    groupChatEnabled: input.groupChatEnabled !== false,
+    groupRequiresAt: input.groupRequiresAt !== false,
+    groupReadEnabled: input.groupReadEnabled !== false,
+    replyFormat,
+    recentGroupMessages: positiveInt(input.recentGroupMessages, DEFAULT_CONFIG.recentGroupMessages),
+    reflectionIdleMs: positiveInt(input.reflectionIdleMs, DEFAULT_CONFIG.reflectionIdleMs),
+    reflectionBatchSize: positiveInt(input.reflectionBatchSize, DEFAULT_CONFIG.reflectionBatchSize),
+    reflectionMaxMessages: positiveInt(input.reflectionMaxMessages, DEFAULT_CONFIG.reflectionMaxMessages),
+    memoryMaxTokens: positiveInt(input.memoryMaxTokens, DEFAULT_CONFIG.memoryMaxTokens),
+    memoryCompressionMaxTokens: positiveInt(input.memoryCompressionMaxTokens, DEFAULT_CONFIG.memoryCompressionMaxTokens),
+  })
+}
+
+export function defaultRuntimeSettings(config: QQChatConfig): QQChatRuntimeSettings {
+  const groupReceiveMode: GroupReceiveMode = !config.groupChatEnabled
+    ? 'silent'
+    : config.groupRequiresAt ? 'mention' : 'auto'
+  return {
+    memoryEnabled: true,
+    groupReceiveMode,
+    groupReplyFormat: 'compat',
+    directReplyFormat: config.replyFormat,
+    directStreamingEnabled: config.replyFormat !== 'compat',
+    groupMembersCanUseTools: false,
+    groupMembersCanReceiveMedia: true,
+    groupMembersCanReadMedia: false,
+    ownerUserId: '',
+  }
+}
+
+function positiveInt(value: unknown, fallback: number): number {
+  return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : fallback
+}
+
+function positiveIntOrUndefined(value: unknown): number | undefined {
+  return Number.isSafeInteger(value) && Number(value) > 0 ? Number(value) : undefined
+}