@zhin.js/plugin-group-suite 3.0.2 → 3.0.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-group-suite",
-  "version": "3.0.2",
-  "description": "Zhin.js 群运营套件 — 群管、签到、统计、日常分析、问答（合并原 5 个插件）",
+  "version": "3.0.3",
+  "description": "Zhin.js 群运营套件 — slice-2 checkin/teach/stats + keywords (Plugin Runtime, in-memory)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,11 +14,14 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.ts",
+    "schema.json",
+    "commands",
+    "middlewares",
     "src",
     "lib",
     "agent",
     "tools",
-    "plugin.yml",
     "README.md"
   ],
   "keywords": [
@@ -29,8 +32,7 @@
     "group",
     "checkin",
     "stats",
-    "teach",
-    "welcome"
+    "teach"
   ],
   "author": {
     "name": "lc-cn",
@@ -39,25 +41,24 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@zhin.js/command": "1.0.1",
+    "@zhin.js/core": "1.3.5",
+    "@zhin.js/middleware": "1.0.1",
+    "@zhin.js/plugin-runtime": "1.0.1",
     "@zhin.js/satori": "1.0.16"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "4.1.2",
-    "@zhin.js/html-renderer": "1.0.3",
-    "@zhin.js/agent": "1.0.3"
+    "@zhin.js/agent": "1.0.4",
+    "zhin.js": "4.1.3"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "zhin.js": "4.1.2",
-    "@zhin.js/agent": "1.0.3",
-    "@zhin.js/html-renderer": "1.0.3"
+    "@zhin.js/agent": "1.0.4"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/html-renderer": {
-      "optional": true
-    },
     "@zhin.js/agent": {
       "optional": true
     },
@@ -74,9 +75,30 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/middleware",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "sh -c 'cd ../../.. && vitest run plugins/utils/group-suite/tests'"
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/group-suite/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,39 @@
+import { definePlugin, databaseHostToken } from '@zhin.js/plugin-runtime';
+import type { GroupSuiteConfig } from './src/config.js';
+import { registerGroupSuiteDb } from './src/db-store.js';
+import { createInMemoryGroupSuiteDb } from './src/memory-store.js';
+import { createGroupSuiteRuntime, groupSuiteRuntimeToken } from './src/runtime-state.js';
+import { flushStatsBuffer } from './src/stats-lib.js';
+import { defineGroupSuiteTables } from './src/tables.js';
+
+/**
+ * Plugin Runtime:
+ * - checkin / teach / stats commands + keyword middleware
+ * - DB: prefer `databaseHostToken`; else in-memory fallback
+ * - Stats buffer: periodic flush every 10s + final flush on dispose
+ */
+export default definePlugin<GroupSuiteConfig>({
+  name: 'group-suite',
+  metadata: {
+    displayName: 'Group Suite',
+  },
+  setup(context) {
+    const db = context.resources.has(databaseHostToken)
+      ? context.resources.use(databaseHostToken)
+      : createInMemoryGroupSuiteDb();
+    if (context.resources.has(databaseHostToken)) {
+      defineGroupSuiteTables(db);
+    }
+    const runtime = createGroupSuiteRuntime(db);
+    context.resources.provide(groupSuiteRuntimeToken, runtime);
+    context.lifecycle.add(registerGroupSuiteDb(db));
+
+    const flushTimer = setInterval(() => {
+      void flushStatsBuffer(runtime);
+    }, 10_000);
+    context.lifecycle.add(async () => {
+      clearInterval(flushTimer);
+      await flushStatsBuffer(runtime);
+    });
+  },
+});

package/schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "keywordReply": { "type": "boolean", "default": false },
+    "basePointsMin": { "type": "number", "default": 10 },
+    "basePointsMax": { "type": "number", "default": 30 },
+    "streakBonus": { "type": "number", "default": 5 },
+    "streakCap": { "type": "number", "default": 50 },
+    "rankSize": { "type": "number", "default": 10 },
+    "teachMaxPerGroup": { "type": "number", "default": 200 },
+    "teachCooldownMs": { "type": "number", "default": 3000 },
+    "teachAllowRegex": { "type": "boolean", "default": true },
+    "teachPageSize": { "type": "number", "default": 10 }
+  }
+}

package/src/checkin-lib.ts

@@ -0,0 +1,148 @@
+import type { GroupSuiteConfig } from './config.js';
+import { getCheckinModel } from './db-store.js';
+import {
+  randomInt,
+  resolveContextKey,
+  resolveSender,
+  todayStr,
+  ts,
+  yesterdayStr,
+} from './shared-runtime.js';
+import type { GroupSuiteRuntime } from './runtime-state.js';
+
+async function getOrCreateUser(
+  model: any,
+  userId: string,
+  userName: string,
+  ctxType: string,
+  ctxId: string,
+): Promise<Record<string, unknown> | null> {
+  const rows = (await model.select().where({
+    user_id: userId,
+    context_type: ctxType,
+    context_id: ctxId,
+  })) as Record<string, unknown>[];
+  if (rows.length > 0) return rows[0];
+
+  await model.insert({
+    user_id: userId,
+    user_name: userName,
+    points: 0,
+    total_checkins: 0,
+    streak: 0,
+    max_streak: 0,
+    last_checkin: '',
+    context_type: ctxType,
+    context_id: ctxId,
+    created_at: ts(),
+    updated_at: ts(),
+  });
+
+  const created = (await model.select().where({
+    user_id: userId,
+    context_type: ctxType,
+    context_id: ctxId,
+  })) as Record<string, unknown>[];
+  return created[0] ?? null;
+}
+
+export async function doCheckin(
+  input: { sender?: string; target?: string; metadata?: Readonly<Record<string, unknown>> },
+  cfg: GroupSuiteConfig,
+  runtime?: GroupSuiteRuntime,
+): Promise<string> {
+  const M = getCheckinModel(runtime?.db);
+  if (!M) return '签到数据库尚未就绪，请稍后重试';
+
+  const { id: userId, name: userName } = resolveSender(input);
+  if (!userId) return '无法获取用户信息';
+
+  const { type: ctxType, id: ctxId } = resolveContextKey(input);
+  const user = await getOrCreateUser(M, userId, userName, ctxType, ctxId);
+  if (!user) return '签到失败，请重试';
+
+  const today = todayStr();
+  if (user.last_checkin === today) {
+    return `你今天已经签到过了哦～\n当前积分: ${user.points}\n连续签到: ${user.streak} 天`;
+  }
+
+  const isConsecutive = user.last_checkin === yesterdayStr();
+  const newStreak = isConsecutive ? Number(user.streak) + 1 : 1;
+  const base = randomInt(cfg.basePointsMin, cfg.basePointsMax);
+  const bonus = Math.min(newStreak * cfg.streakBonus, cfg.streakCap);
+  const earned = base + bonus;
+  const newPoints = Number(user.points || 0) + earned;
+
+  await M.update({
+    points: newPoints,
+    total_checkins: Number(user.total_checkins || 0) + 1,
+    streak: newStreak,
+    max_streak: Math.max(Number(user.max_streak || 0), newStreak),
+    last_checkin: today,
+    user_name: userName,
+    updated_at: ts(),
+  }).where({
+    user_id: userId,
+    context_type: ctxType,
+    context_id: ctxId,
+  });
+
+  const lines = [`签到成功！`, `基础积分: +${base}`];
+  if (bonus > 0) lines.push(`连续奖励: +${bonus} (连续${newStreak}天)`);
+  lines.push(`本次获得: +${earned}`, `当前积分: ${newPoints}`);
+  return lines.join('\n');
+}
+
+export async function myPoints(
+  input: { sender?: string; target?: string; metadata?: Readonly<Record<string, unknown>> },
+  runtime?: GroupSuiteRuntime,
+): Promise<string> {
+  const M = getCheckinModel(runtime?.db);
+  if (!M) return '签到数据库尚未就绪';
+  const { id: userId } = resolveSender(input);
+  const { type: ctxType, id: ctxId } = resolveContextKey(input);
+  const rows = (await M.select().where({
+    user_id: userId,
+    context_type: ctxType,
+    context_id: ctxId,
+  })) as Record<string, unknown>[];
+  if (rows.length === 0) return '你还没有签到记录哦，发送「checkin」开始吧！';
+  const u = rows[0];
+  const checkedToday = u.last_checkin === todayStr();
+  return [
+    `${u.user_name || '用户'} 的积分信息`,
+    `积分: ${u.points}`,
+    `累计签到: ${u.total_checkins} 天`,
+    `连续签到: ${u.streak} 天`,
+    `最长连续: ${u.max_streak} 天`,
+    checkedToday ? '今日已签到 ✓' : '今日未签到',
+  ].join('\n');
+}
+
+export async function pointsRank(
+  input: { sender?: string; target?: string; metadata?: Readonly<Record<string, unknown>> },
+  cfg: GroupSuiteConfig,
+  runtime?: GroupSuiteRuntime,
+): Promise<string> {
+  const M = getCheckinModel(runtime?.db);
+  if (!M) return '签到数据库尚未就绪';
+  const { type: ctxType, id: ctxId } = resolveContextKey(input);
+  const all = (await M.select().where(
+    ctxType === 'global'
+      ? { context_type: 'global' }
+      : { context_type: ctxType, context_id: ctxId },
+  )) as Record<string, unknown>[];
+  if (all.length === 0) return '还没有人签到过哦～';
+  const sorted = all.sort((a, b) => Number(b.points || 0) - Number(a.points || 0));
+  const top = sorted.slice(0, cfg.rankSize);
+  const medals = ['🥇', '🥈', '🥉'];
+  const lines = top.map((u, i) => {
+    const prefix = i < 3 ? medals[i] : `${i + 1}.`;
+    return `${prefix} ${u.user_name || u.user_id} — ${u.points}分 (${u.total_checkins}天)`;
+  });
+  const title = ctxType === 'group' ? '本群积分排行' : '全局积分排行';
+  const { id: userId } = resolveSender(input);
+  const myRank = sorted.findIndex((u) => u.user_id === userId);
+  const footer = myRank >= 0 ? `\n你的排名: 第${myRank + 1}名` : '';
+  return `${title}\n${lines.join('\n')}${footer}`;
+}

package/src/config.ts

@@ -1,68 +1,34 @@
-import { Schema } from "zhin.js";
-
-/** 扁平 groupSuite 配置（单层字段，默认值覆盖多数场景） */
-export const groupSuiteSchema = Schema.object({
-  welcome: Schema.string()
-    .default("欢迎新成员加入本群！")
-    .description("入群欢迎语"),
-  recallNotify: Schema.boolean()
-    .default(true)
-    .description("群消息撤回时是否提示"),
-  keywordReply: Schema.boolean()
-    .default(false)
-    .description("内置关键词回复（默认关闭，用 teach 问答）"),
-  noticeAdapters: Schema.list(Schema.string())
-    .default(["icqq"])
-    .description("处理 notice 的适配器（欢迎/撤回）"),
-
-  basePointsMin: Schema.number().default(10).min(1).max(100),
-  basePointsMax: Schema.number().default(30).min(1).max(200),
-  streakBonus: Schema.number().default(5).min(0).max(100),
-  streakCap: Schema.number().default(50).min(0).max(500),
-
-  rankSize: Schema.number()
-    .default(10)
-    .min(3)
-    .max(50)
-    .description("签到排行与消息统计排行显示人数"),
-  statsRetentionDays: Schema.number().default(90).min(7).max(365),
-
-  analysisDays: Schema.number().default(1).min(1).max(30),
-  autoAnalysisEnabled: Schema.boolean().default(false),
-  autoAnalysisCron: Schema.string().default("0 0 9 * * *"),
-  analysisGroups: Schema.list(Schema.string())
-    .default([])
-    .description("启用群日报的群 ID 白名单（空=不限制）"),
-  analysisGroupsBlock: Schema.list(Schema.string())
-    .default([])
-    .description("禁用群日报的群 ID"),
-  analysisMaxMessages: Schema.number().default(500).min(100).max(5000),
-
-  teachMaxPerGroup: Schema.number().default(200).min(1).max(1000),
-  teachCooldownMs: Schema.number().default(3000).min(0).max(60000),
-  teachAllowRegex: Schema.boolean().default(true),
-  teachPageSize: Schema.number().default(10).min(5).max(50),
-});
-
-export type GroupSuiteConfig = {
-  welcome: string;
-  recallNotify: boolean;
+export interface GroupSuiteConfig {
   keywordReply: boolean;
-  noticeAdapters: string[];
   basePointsMin: number;
   basePointsMax: number;
   streakBonus: number;
   streakCap: number;
   rankSize: number;
-  statsRetentionDays: number;
-  analysisDays: number;
-  autoAnalysisEnabled: boolean;
-  autoAnalysisCron: string;
-  analysisGroups: string[];
-  analysisGroupsBlock: string[];
-  analysisMaxMessages: number;
   teachMaxPerGroup: number;
   teachCooldownMs: number;
   teachAllowRegex: boolean;
   teachPageSize: number;
+}
+
+export const DEFAULT_GROUP_SUITE_CONFIG: GroupSuiteConfig = {
+  keywordReply: false,
+  basePointsMin: 10,
+  basePointsMax: 30,
+  streakBonus: 5,
+  streakCap: 50,
+  rankSize: 10,
+  teachMaxPerGroup: 200,
+  teachCooldownMs: 3000,
+  teachAllowRegex: true,
+  teachPageSize: 10,
 };
+
+export function resolveGroupSuiteConfig(
+  raw: Partial<GroupSuiteConfig> | undefined,
+): GroupSuiteConfig {
+  return {
+    ...DEFAULT_GROUP_SUITE_CONFIG,
+    ...raw,
+  };
+}

package/src/db-store.ts

@@ -0,0 +1,51 @@
+import {
+  CHECKIN_TABLE,
+  createInMemoryGroupSuiteDb,
+  STATS_TABLE,
+  TEACH_TABLE,
+  type GroupSuiteMemoryDb,
+  type GroupSuiteModel,
+} from './memory-store.js';
+
+let _db: GroupSuiteMemoryDb | null = null;
+const registrations: Array<{ readonly value: GroupSuiteMemoryDb }> = [];
+
+/** Ensure an in-memory store when Runtime DatabaseFeature Resource is not wired yet. */
+export function ensureGroupSuiteMemoryDb(): GroupSuiteMemoryDb {
+  if (!_db) _db = createInMemoryGroupSuiteDb();
+  return _db;
+}
+
+export function getGroupSuiteDb(): GroupSuiteMemoryDb | null {
+  return registrations[registrations.length - 1]?.value ?? ensureGroupSuiteMemoryDb();
+}
+
+export function setGroupSuiteDb(db: GroupSuiteMemoryDb | null): void {
+  _db = db;
+}
+
+export function registerGroupSuiteDb(db: GroupSuiteMemoryDb): () => void {
+  const registration = Object.freeze({ value: db });
+  registrations.push(registration);
+  return () => {
+    const index = registrations.lastIndexOf(registration);
+    if (index >= 0) registrations.splice(index, 1);
+  };
+}
+
+/** Test helper: clear module store. */
+export function resetGroupSuiteDb(): void {
+  _db = null;
+}
+
+export function getCheckinModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
+  return db?.models.get(CHECKIN_TABLE) ?? null;
+}
+
+export function getTeachModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
+  return db?.models.get(TEACH_TABLE) ?? null;
+}
+
+export function getStatsModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
+  return db?.models.get(STATS_TABLE) ?? null;
+}

package/src/index.ts

@@ -1,33 +1,47 @@
-/**
- * @zhin.js/plugin-group-suite
- *
- * ```yaml
- * plugins:
- *   - "@zhin.js/plugin-group-suite"
- * inbox:
- *   enabled: true
- * groupSuite:
- *   noticeAdapters: [icqq]
- *   autoAnalysisEnabled: true
- * ```
- */
-import { formatCompact, usePlugin } from "zhin.js";
-import { groupSuiteSchema } from "./config.js";
-import { registerAdmin } from "./admin.js";
-import { registerCheckin } from "./checkin.js";
-import { registerDailyAnalysis } from "./daily-analysis.js";
-import { registerStats } from "./stats.js";
-import { registerTeach } from "./teach.js";
-
-const plugin = usePlugin();
-const { logger, declareConfig } = plugin;
-
-const cfg = declareConfig("groupSuite", groupSuiteSchema);
-
-registerAdmin(plugin, cfg);
-registerCheckin(plugin, cfg);
-registerStats(plugin, cfg);
-registerDailyAnalysis(plugin, cfg);
-registerTeach(plugin, cfg);
-
-logger.debug(formatCompact({ 模块: "群组套件", 状态: "已加载" }));
+export {
+  DEFAULT_GROUP_SUITE_CONFIG,
+  resolveGroupSuiteConfig,
+} from './config.js';
+export type { GroupSuiteConfig } from './config.js';
+export { doCheckin, myPoints, pointsRank } from './checkin-lib.js';
+export {
+  addKeyword,
+  listKeywords,
+  matchKeyword,
+  removeKeyword,
+  resetKeywords,
+} from './keyword-store.js';
+export {
+  ensureGroupSuiteMemoryDb,
+  getCheckinModel,
+  getGroupSuiteDb,
+  getStatsModel,
+  getTeachModel,
+  resetGroupSuiteDb,
+  registerGroupSuiteDb,
+  setGroupSuiteDb,
+} from './db-store.js';
+export {
+  createGroupSuiteRuntime,
+  groupSuiteRuntimeToken,
+  resolveGroupSuiteRuntime,
+} from './runtime-state.js';
+export type { GroupSuiteRuntime, PendingStatsIncrement } from './runtime-state.js';
+export {
+  parseTeachPair,
+  resetTeachCooldown,
+  teachAdd,
+  teachForget,
+  teachList,
+  tryTeachReply,
+} from './teach-lib.js';
+export {
+  flushStatsBuffer,
+  monthStartStr,
+  myStatsText,
+  queryStats,
+  recordMessage,
+  resetStatsBuffer,
+  statsRankText,
+  weekStartStr,
+} from './stats-lib.js';

package/src/keyword-store.ts

@@ -0,0 +1,24 @@
+const keywords = new Map<string, string>();
+
+export function addKeyword(keyword: string, reply: string, store = keywords): void {
+  store.set(keyword, reply);
+}
+
+export function removeKeyword(keyword: string, store = keywords): boolean {
+  return store.delete(keyword);
+}
+
+export function listKeywords(store = keywords): Array<[string, string]> {
+  return Array.from(store.entries());
+}
+
+export function matchKeyword(text: string, store = keywords): string | null {
+  for (const [keyword, reply] of store) {
+    if (text.includes(keyword)) return reply;
+  }
+  return null;
+}
+
+export function resetKeywords(): void {
+  keywords.clear();
+}

package/src/memory-store.ts

@@ -0,0 +1,88 @@
+/**
+ * In-memory group-suite models (slice-2) until Plugin Runtime DatabaseFeature Resource lands.
+ */
+
+export interface GroupSuiteRow extends Record<string, unknown> {
+  id: string;
+}
+
+export interface GroupSuiteModel {
+  select: () => {
+    where: (query: Record<string, unknown>) => Promise<GroupSuiteRow[]>;
+    then: <TResult1 = GroupSuiteRow[], TResult2 = never>(
+      onfulfilled?: ((value: GroupSuiteRow[]) => TResult1 | PromiseLike<TResult1>) | null,
+      onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,
+    ) => Promise<TResult1 | TResult2>;
+  };
+  insert: (row: Record<string, unknown>) => Promise<GroupSuiteRow>;
+  delete: () => { where: (query: Record<string, unknown>) => Promise<void> };
+  update: (patch: Record<string, unknown>) => {
+    where: (query: Record<string, unknown>) => Promise<void>;
+  };
+}
+
+function createMemoryModel(): GroupSuiteModel {
+  const rows: GroupSuiteRow[] = [];
+  let nextId = 1;
+
+  function matches(row: Record<string, unknown>, query: Record<string, unknown>): boolean {
+    return Object.entries(query).every(([key, value]) => row[key] === value);
+  }
+
+  function all(): GroupSuiteRow[] {
+    return rows.map((row) => ({ ...row }));
+  }
+
+  return {
+    select: () => {
+      const promise = Promise.resolve(all());
+      return {
+        where: async (query: Record<string, unknown>) =>
+          rows.filter((row) => matches(row, query)).map((row) => ({ ...row })),
+        then: (onfulfilled, onrejected) => promise.then(onfulfilled, onrejected),
+      };
+    },
+    insert: async (row: Record<string, unknown>) => {
+      const withId: GroupSuiteRow = { id: String(nextId++), ...row };
+      rows.push(withId);
+      return { ...withId };
+    },
+    delete: () => ({
+      where: async (query: Record<string, unknown>) => {
+        for (let i = rows.length - 1; i >= 0; i -= 1) {
+          if (matches(rows[i]!, query)) rows.splice(i, 1);
+        }
+      },
+    }),
+    update: (patch: Record<string, unknown>) => ({
+      where: async (query: Record<string, unknown>) => {
+        for (const row of rows) {
+          if (matches(row, query)) Object.assign(row, patch);
+        }
+      },
+    }),
+  };
+}
+
+export interface GroupSuiteMemoryDb {
+  models: {
+    get: (name: string) => GroupSuiteModel | undefined;
+  };
+}
+
+export const CHECKIN_TABLE = 'checkin_records';
+export const TEACH_TABLE = 'teach_qa';
+export const STATS_TABLE = 'message_stats';
+
+export function createInMemoryGroupSuiteDb(): GroupSuiteMemoryDb {
+  const models = new Map<string, GroupSuiteModel>([
+    [CHECKIN_TABLE, createMemoryModel()],
+    [TEACH_TABLE, createMemoryModel()],
+    [STATS_TABLE, createMemoryModel()],
+  ]);
+  return {
+    models: {
+      get: (name: string) => models.get(name),
+    },
+  };
+}

package/src/runtime-state.ts

@@ -0,0 +1,44 @@
+import { createToken } from '@zhin.js/plugin-runtime';
+import type { GroupSuiteMemoryDb } from './memory-store.js';
+
+export interface PendingStatsIncrement {
+  user_id: string;
+  user_name: string;
+  group_id: string;
+  date: string;
+  count: number;
+}
+
+/** All mutable state owned by one group-suite plugin instance. */
+export interface GroupSuiteRuntime {
+  readonly db: GroupSuiteMemoryDb;
+  readonly keywords: Map<string, string>;
+  readonly teachCooldowns: Map<string, number>;
+  readonly statsBuffer: Map<string, PendingStatsIncrement>;
+}
+
+export const groupSuiteRuntimeToken = createToken<GroupSuiteRuntime>(
+  'zhin.group-suite.runtime',
+  'Owner-scoped Group Suite database and ephemeral state',
+);
+
+export function createGroupSuiteRuntime(db: GroupSuiteMemoryDb): GroupSuiteRuntime {
+  return {
+    db,
+    keywords: new Map(),
+    teachCooldowns: new Map(),
+    statsBuffer: new Map(),
+  };
+}
+
+export function resolveGroupSuiteRuntime(context: {
+  owner?: { id?: unknown };
+  use<T>(token: typeof groupSuiteRuntimeToken): T;
+}): GroupSuiteRuntime | undefined {
+  try {
+    return context.use(groupSuiteRuntimeToken) as GroupSuiteRuntime;
+  } catch (error) {
+    if (context.owner?.id) throw error;
+    return undefined;
+  }
+}