@bbigbang/core 0.1.0

package/dist/web/agentChannelGuards.js

@@ -0,0 +1,48 @@
+/**
+ * 判定 agent 是否可在给定 channel 写入/读取。
+ * DM channel（channelId 形如 `dm:<agentId>`）仅该 agent 自己通过；
+ * 普通 channel 查 `agent_channel_memberships` 表。
+ */
+export function isAgentMemberOfChannel(db, agentId, channelId) {
+    if (!agentId || !channelId)
+        return false;
+    if (channelId.startsWith('dm:')) {
+        return channelId === `dm:${agentId}`;
+    }
+    const row = db
+        .prepare(`SELECT 1 AS ok FROM agent_channel_memberships WHERE agent_id = ? AND channel_id = ? LIMIT 1`)
+        .get(agentId, channelId);
+    return row?.ok === 1;
+}
+/**
+ * 构造 agent 端 "channel 成员前置拒绝" 响应。
+ * 调用方：reply.code(denial.status); return denial.body;
+ */
+export function buildAgentChannelMembershipDenial(params) {
+    const channelName = params.channelName?.trim() || null;
+    const label = channelName ? `#${channelName}` : `channel ${params.channelId}`;
+    return {
+        status: 403,
+        body: {
+            error: `This agent is not a member of ${label}. Ask the user to add the agent to the channel before retrying.`,
+            error_code: 'channel_membership_required',
+            required_action: 'ask_user_to_add_agent_to_channel',
+            source_target: params.sourceTarget ?? null,
+            requested_target: {
+                type: 'channel',
+                channelId: params.channelId,
+                channelName,
+            },
+        },
+    };
+}
+/** 读取 channel 的 name（仅展示用；缺则 null） */
+export function loadChannelName(db, channelId) {
+    if (!channelId || channelId.startsWith('dm:'))
+        return null;
+    const row = db
+        .prepare(`SELECT name AS name FROM channels WHERE channel_id = ? LIMIT 1`)
+        .get(channelId);
+    const name = row?.name?.trim();
+    return name ? name : null;
+}

package/dist/web/agentMentionCooldowns.js

@@ -0,0 +1,32 @@
+function normalizeThreadRootId(threadRootId) {
+    return threadRootId ?? '';
+}
+export function recordAgentMentionNotification(db, params) {
+    const notifiedAt = params.notifiedAt ?? Date.now();
+    db.prepare(`INSERT INTO agent_mention_cooldowns(channel_id, thread_root_id, from_agent_id, to_agent_id, last_notified_at)
+     VALUES(?, ?, ?, ?, ?)
+     ON CONFLICT(channel_id, thread_root_id, from_agent_id, to_agent_id) DO UPDATE
+       SET last_notified_at = excluded.last_notified_at`).run(params.channelId, normalizeThreadRootId(params.threadRootId), params.fromAgentId, params.toAgentId, notifiedAt);
+}
+export function shouldTriggerAgentMention(db, params) {
+    const now = params.now ?? Date.now();
+    const row = db.prepare(`SELECT last_notified_at as lastNotifiedAt
+     FROM agent_mention_cooldowns
+     WHERE channel_id = ? AND thread_root_id = ? AND from_agent_id = ? AND to_agent_id = ?`).get(params.channelId, normalizeThreadRootId(params.threadRootId), params.fromAgentId, params.toAgentId);
+    return !row || (now - row.lastNotifiedAt) >= params.cooldownMs;
+}
+export function clearAgentMentionCooldownsForChannelChatClear(db, params) {
+    const preservedThreadRootIds = [...new Set((params.preservedThreadRootIds ?? []).map((id) => id.trim()).filter(Boolean))];
+    if (preservedThreadRootIds.length === 0) {
+        db.prepare(`DELETE FROM agent_mention_cooldowns
+       WHERE channel_id = ?`).run(params.channelId);
+        return;
+    }
+    const placeholders = preservedThreadRootIds.map(() => '?').join(', ');
+    db.prepare(`DELETE FROM agent_mention_cooldowns
+     WHERE channel_id = ?
+       AND (
+         COALESCE(thread_root_id, '') = ''
+         OR thread_root_id NOT IN (${placeholders})
+       )`).run(params.channelId, ...preservedThreadRootIds);
+}