@zhin.js/plugin-rss 1.0.1 → 1.1.1

package/lib/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY7F;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1G;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA4BD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;IACrE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBrE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAO5E"}

package/lib/poll.js

@@ -0,0 +1,147 @@
+/**
+ * Feed poll helpers: detect new items; optional OutboundHost push to subscribers.
+ */
+import { fetchFeed } from './feed.js';
+import { getRssSeen, getRssSubs } from './db-store.js';
+function ts() {
+    return new Date().toISOString();
+}
+export function formatNewItems(feedTitle, items, maxItems) {
+    const lines = [`${feedTitle} 有 ${items.length} 条新内容：`];
+    for (const item of items.slice(0, maxItems)) {
+        lines.push('');
+        lines.push(`${item.title}`);
+        if (item.summary)
+            lines.push(item.summary);
+        if (item.link)
+            lines.push(item.link);
+    }
+    if (items.length > maxItems) {
+        lines.push(`\n...还有 ${items.length - maxItems} 条，请查看源站`);
+    }
+    return lines.join('\n');
+}
+export async function markItemsSeen(runtime, feedUrl, items) {
+    const Seen = getRssSeen(runtime.db);
+    if (!Seen)
+        return;
+    for (const item of items) {
+        const dup = await Seen.select().where({ feed_url: feedUrl, item_guid: item.guid });
+        if (dup.length === 0) {
+            await Seen.insert({
+                feed_url: feedUrl,
+                item_guid: item.guid,
+                item_title: item.title,
+                seen_at: ts(),
+            });
+        }
+    }
+}
+async function pushToSubscribers(runtime, feedUrl, content) {
+    const push = runtime.outbound;
+    const Subs = getRssSubs(runtime.db);
+    if (!push || !Subs)
+        return 0;
+    const subscribers = await Subs.select().where({ url: feedUrl });
+    let pushed = 0;
+    for (const sub of subscribers) {
+        const adapterName = String(sub.adapter_name ?? '');
+        const channelId = String(sub.channel_id ?? '');
+        if (!adapterName || !channelId)
+            continue;
+        try {
+            await push({
+                adapterName,
+                endpointKey: String(sub.endpoint_id ?? adapterName),
+                channelType: String(sub.channel_type ?? 'private'),
+                channelId,
+                content,
+            });
+            pushed += 1;
+        }
+        catch {
+            // OutboundHost already logs; continue other subscribers.
+        }
+    }
+    return pushed;
+}
+/**
+ * Check subscribed feeds for new items and mark them seen.
+ * When OutboundHost is wired, pushes formatted text to each subscriber channel.
+ */
+export async function checkSubscriptions(runtime, options) {
+    const Seen = getRssSeen(runtime.db);
+    const Subs = getRssSubs(runtime.db);
+    if (!Seen || !Subs) {
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    }
+    const parts = [];
+    let totalNew = 0;
+    let pushed = 0;
+    for (const url of options.urls) {
+        try {
+            const { title, items } = await fetchFeed(url, runtime.config.timeout);
+            const seenRows = await Seen.select().where({ feed_url: url });
+            const seenGuids = new Set(seenRows.map((r) => String(r.item_guid ?? '')));
+            const newItems = items.filter((item) => item.guid && !seenGuids.has(item.guid));
+            if (newItems.length === 0) {
+                parts.push(`${title || url}: 无新内容`);
+                continue;
+            }
+            await markItemsSeen(runtime, url, newItems);
+            totalNew += newItems.length;
+            const body = formatNewItems(title || url, newItems, runtime.config.maxItems);
+            parts.push(body);
+            pushed += await pushToSubscribers(runtime, url, body);
+        }
+        catch (e) {
+            parts.push(`${url}: 检查失败 — ${e.message}`);
+        }
+    }
+    if (parts.length === 0)
+        return { text: '没有可检查的订阅', totalNew: 0, pushed: 0 };
+    const pushNote = runtime.outbound
+        ? (pushed > 0 ? `，已推送 ${pushed} 个会话` : '，无出站推送')
+        : '（未装配 OutboundHost，仅本地标记）';
+    const header = totalNew > 0
+        ? `检查完成，共 ${totalNew} 条新内容${pushNote}`
+        : '检查完成，暂无新内容';
+    return { text: `${header}\n\n${parts.join('\n\n')}`, totalNew, pushed };
+}
+/**
+ * Periodically clean seen records older than 7 days.
+ */
+export async function cleanOldSeen(runtime) {
+    const Seen = getRssSeen(runtime.db);
+    if (!Seen)
+        return;
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 7);
+        const cutoffStr = cutoff.toISOString();
+        const all = await Seen.select();
+        const expired = all.filter((r) => typeof r.seen_at === 'string' && r.seen_at < cutoffStr);
+        for (const row of expired) {
+            // 表结构没有 id 列，按业务键 (feed_url, item_guid) 删除。
+            await Seen.delete().where({ feed_url: row.feed_url, item_guid: row.item_guid });
+        }
+    }
+    catch (e) {
+        // Cleanup failure must not break the main flow, but it must be visible.
+        console.warn(`[rss] cleanOldSeen failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+/**
+ * Poll all unique feed URLs across subscriptions.
+ */
+export async function pollAllFeeds(runtime) {
+    const Subs = getRssSubs(runtime.db);
+    if (!Subs)
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    const all = await Subs.select();
+    const urls = [...new Set(all.map((s) => String(s.url ?? '')).filter(Boolean))];
+    if (urls.length === 0)
+        return { text: '暂无任何 RSS 订阅', totalNew: 0, pushed: 0 };
+    return checkSubscriptions(runtime, { urls });
+}
+//# sourceMappingURL=poll.js.map

package/lib/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"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"}

package/lib/runtime.d.ts

@@ -0,0 +1,16 @@
+import type { RssConfig } from './feed.js';
+import type { RssMemoryDb } from './memory-store.js';
+export type RssOutboundPush = (input: {
+    readonly adapterName: string;
+    readonly endpointKey: string;
+    readonly channelType: string;
+    readonly channelId: string;
+    readonly content: string;
+}) => Promise<void>;
+export interface RssRuntime {
+    readonly db: RssMemoryDb;
+    readonly config: Readonly<RssConfig>;
+    readonly outbound: RssOutboundPush | null;
+}
+export declare const rssRuntimeToken: import("zhin.js").Token<RssRuntime>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED,eAAO,MAAM,eAAe,qCAG3B,CAAC"}

package/lib/runtime.js

@@ -0,0 +1,3 @@
+import { createToken } from 'zhin.js';
+export const rssRuntimeToken = createToken('zhin.rss.runtime', 'Owner-scoped RSS runtime');
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAkBtC,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CACxC,kBAAkB,EAClB,0BAA0B,CAC3B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-rss",
-  "version": "1.0.1",
-  "description": "RSS/Atom feed subscription & push plugin for Zhin.js — subscribe feeds, auto-poll, push new items to groups",
+  "version": "1.1.1",
+  "description": "RSS/Atom feed subscription plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,10 +14,12 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
     "src",
     "lib",
-    "client",
-    "dist",
+    "tools",
     "skills",
     "README.md"
   ],
@@ -30,10 +32,7 @@
     "atom",
     "feed",
     "subscription",
-    "push",
-    "notify",
-    "chatbot",
-    "im"
+    "push"
   ],
   "author": {
     "name": "lc-cn",
@@ -42,14 +41,28 @@
   },
   "license": "MIT",
   "dependencies": {
-    "rss-parser": "^3.13.0"
+    "rss-parser": "^3.13.0",
+    "@zhin.js/tool": "1.1.1",
+    "@zhin.js/skill": "1.1.1"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "2.0.1"
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "zhin.js": "1.1.2"
   },
   "peerDependencies": {
-    "zhin.js": "2.0.1"
+    "zod": "^4.0.0",
+    "zhin.js": "^1.1.2",
+    "@zhin.js/command": "^1.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "repository": {
     "type": "git",
@@ -60,8 +73,34 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/rss/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,88 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin, databaseHostToken, outboundHostToken, scheduleHostToken, } from 'zhin.js';
+import { resolveRssConfig } from "./lib/feed.js";
+import { createInMemoryRssDb, RSS_SEEN_TABLE, RSS_SUBS_TABLE, } from "./lib/db-store.js";
+import { cleanOldSeen, pollAllFeeds } from "./lib/poll.js";
+import { rssRuntimeToken } from "./lib/runtime.js";
+function defineRssTables(db) {
+    db.define(RSS_SUBS_TABLE, {
+        url: { type: 'text', nullable: false },
+        feed_title: { type: 'text', default: '' },
+        adapter_name: { type: 'text', nullable: false },
+        endpoint_id: { type: 'text', default: '' },
+        channel_type: { type: 'text', default: 'private' },
+        channel_id: { type: 'text', nullable: false },
+        creator_id: { type: 'text', default: '' },
+        creator_name: { type: 'text', default: '' },
+        created_at: { type: 'text', default: '' },
+    });
+    db.define(RSS_SEEN_TABLE, {
+        feed_url: { type: 'text', nullable: false },
+        item_guid: { type: 'text', nullable: false },
+        item_title: { type: 'text', default: '' },
+        seen_at: { type: 'text', default: '' },
+    });
+}
+/**
+ * Plugin Runtime:
+ * - Commands: add/list/remove/check.
+ * - DB: prefer `databaseHostToken`; else in-memory.
+ * - Outbound: `outboundHostToken` pushes new items to subscriber channels.
+ * - Cron: `scheduleHostToken` poll job when available.
+ */
+export default definePlugin({
+    name: 'rss',
+    metadata: {
+        displayName: 'RSS',
+    },
+    setup(context) {
+        const config = resolveRssConfig(context.config.get());
+        const db = context.resources.has(databaseHostToken) ? (() => {
+            const host = context.resources.use(databaseHostToken);
+            defineRssTables(host);
+            return host;
+        })() : createInMemoryRssDb();
+        let outboundPush = null;
+        if (context.resources.has(outboundHostToken)) {
+            const outbound = context.resources.use(outboundHostToken);
+            outboundPush = async (input) => {
+                await outbound.send({
+                    adapter: input.adapterName,
+                    endpointKey: input.endpointKey,
+                    conversation: {
+                        kind: input.channelType,
+                        id: input.channelId,
+                    },
+                    content: input.content,
+                });
+            };
+        }
+        const runtime = Object.freeze({
+            db,
+            config: Object.freeze({ ...config }),
+            outbound: outboundPush,
+        });
+        context.resources.provide(rssRuntimeToken, runtime);
+        if (!context.resources.has(scheduleHostToken))
+            return;
+        const schedule = context.resources.use(scheduleHostToken);
+        const dispose = schedule.register({
+            id: 'rss/poll_feeds',
+            cron: config.pollCron,
+            description: 'Poll RSS subscriptions',
+            async execute() {
+                await pollAllFeeds(runtime);
+            },
+        });
+        const disposeClean = schedule.register({
+            id: 'rss/clean_old_seen',
+            cron: '0 0 4 * * *',
+            description: 'Clean seen records older than 7 days',
+            async execute() {
+                await cleanOldSeen(runtime);
+            },
+        });
+        context.lifecycle.add(dispose);
+        context.lifecycle.add(disposeClean);
+    },
+});

package/schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pollCron": {
+      "type": "string",
+      "default": "0 */5 * * * *",
+      "description": "轮询频率 (6 段 Cron 表达式)"
+    },
+    "maxPerGroup": {
+      "type": "number",
+      "default": 30,
+      "minimum": 1,
+      "maximum": 200
+    },
+    "maxItems": {
+      "type": "number",
+      "default": 5,
+      "minimum": 1,
+      "maximum": 20
+    },
+    "timeout": {
+      "type": "number",
+      "default": 15000,
+      "minimum": 1000,
+      "maximum": 60000
+    }
+  }
+}

package/skills/rss/tools/rss_list_subscriptions/index.js

@@ -0,0 +1,32 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getRssSubs } from "../../../../lib/db-store.js";
+import { rssRuntimeToken } from "../../../../lib/runtime.js";
+export default defineAgentTool({
+    description: '查询当前所有 RSS 订阅',
+    inputSchema: z.object({}),
+    async execute(_input, context) {
+        const Subs = getRssSubs(context.use(rssRuntimeToken).db);
+        if (!Subs)
+            return 'RSS 数据库尚未就绪';
+        const all = (await Subs.select());
+        if (all.length === 0)
+            return '暂无任何 RSS 订阅';
+        const grouped = new Map();
+        for (const sub of all) {
+            const key = `${sub.channel_type}:${sub.channel_id}`;
+            const list = grouped.get(key) || [];
+            list.push(sub);
+            grouped.set(key, list);
+        }
+        const lines = [];
+        for (const [channel, subs] of grouped) {
+            lines.push(`[${channel}]`);
+            for (const s of subs) {
+                lines.push(`  - ${s.feed_title || s.url}`);
+            }
+        }
+        return `RSS 订阅总览 (${all.length} 条):\n${lines.join('\n')}`;
+    },
+});

package/skills/rss/tools/rss_list_subscriptions/index.ts

@@ -0,0 +1,38 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { getRssSubs } from '../../../../src/db-store.js';
+import { rssRuntimeToken } from '../../../../src/runtime.js';
+
+export default defineAgentTool({
+  description: '查询当前所有 RSS 订阅',
+  inputSchema: z.object({}),
+  async execute(_input, context) {
+    const Subs = getRssSubs(context.use(rssRuntimeToken).db);
+    if (!Subs) return 'RSS 数据库尚未就绪';
+
+    const all = (await Subs.select()) as Array<{
+      channel_type: string;
+      channel_id: string;
+      feed_title?: string;
+      url: string;
+    }>;
+    if (all.length === 0) return '暂无任何 RSS 订阅';
+
+    const grouped = new Map<string, typeof all>();
+    for (const sub of all) {
+      const key = `${sub.channel_type}:${sub.channel_id}`;
+      const list = grouped.get(key) || [];
+      list.push(sub);
+      grouped.set(key, list);
+    }
+
+    const lines: string[] = [];
+    for (const [channel, subs] of grouped) {
+      lines.push(`[${channel}]`);
+      for (const s of subs) {
+        lines.push(`  - ${s.feed_title || s.url}`);
+      }
+    }
+    return `RSS 订阅总览 (${all.length} 条):\n${lines.join('\n')}`;
+  },
+});

package/skills/rss/tools/rss_preview_feed/index.js

@@ -0,0 +1,26 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { fetchFeed } from "../../../../lib/feed.js";
+import { rssRuntimeToken } from "../../../../lib/runtime.js";
+export default defineAgentTool({
+    description: '预览一个 RSS 源的最新内容',
+    inputSchema: z.object({ url: z.string().min(1) }),
+    async execute({ url }, context) {
+        if (!url)
+            return '请提供 RSS 源 URL';
+        try {
+            const runtime = context.use(rssRuntimeToken);
+            const { title, items } = await fetchFeed(url, runtime.config.timeout);
+            if (items.length === 0)
+                return `${title}: 无内容`;
+            return items
+                .slice(0, 5)
+                .map((item, i) => `${i + 1}. ${item.title}\n   ${item.link}`)
+                .join('\n');
+        }
+        catch (e) {
+            return `解析失败: ${e.message}`;
+        }
+    },
+});

package/skills/rss/tools/rss_preview_feed/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { fetchFeed } from '../../../../src/feed.js';
+import { rssRuntimeToken } from '../../../../src/runtime.js';
+
+export default defineAgentTool<{ url: string }>({
+  description: '预览一个 RSS 源的最新内容',
+  inputSchema: z.object({ url: z.string().min(1) }),
+  async execute({ url }, context) {
+    if (!url) return '请提供 RSS 源 URL';
+    try {
+      const runtime = context.use(rssRuntimeToken);
+      const { title, items } = await fetchFeed(url, runtime.config.timeout);
+      if (items.length === 0) return `${title}: 无内容`;
+      return items
+        .slice(0, 5)
+        .map((item, i) => `${i + 1}. ${item.title}\n   ${item.link}`)
+        .join('\n');
+    } catch (e) {
+      return `解析失败: ${(e as Error).message}`;
+    }
+  },
+});

package/src/channel.ts

@@ -0,0 +1,69 @@
+/**
+ * Extract subscription channel keys from Runtime Message (`input`).
+ * Gaps vs legacy: no `$channel` / `$group` — use `conversation` / `metadata`.
+ */
+
+export interface ChannelInfo {
+  adapterName: string;
+  endpointKey: string;
+  channelType: string;
+  channelId: string;
+  senderId: string;
+  senderName: string;
+}
+
+/** Smoke / agent / execute()-without-dispatch fallback. */
+export const SMOKE_CHANNEL: ChannelInfo = {
+  adapterName: 'smoke',
+  endpointKey: 'local',
+  channelType: 'private',
+  channelId: 'global',
+  senderId: '',
+  senderName: '',
+};
+
+export function extractChannelInfo(input: unknown): ChannelInfo {
+  if (!input || typeof input !== 'object') return { ...SMOKE_CHANNEL };
+
+  const msg = input as {
+    conversation?: {
+      endpoint?: { id?: string; adapter?: string };
+      kind?: string;
+      id?: string;
+    };
+    sender?: string;
+    metadata?: Record<string, unknown>;
+  };
+  const meta = msg.metadata ?? {};
+  const conversation = msg.conversation;
+  const channelType = String(
+    meta.channelType ?? meta.type ?? meta.channel_type ?? conversation?.kind ?? 'private',
+  );
+  const channelId = String(
+    meta.channelId ?? meta.channel_id ?? conversation?.id ?? SMOKE_CHANNEL.channelId,
+  );
+  const endpointCapabilityId = typeof conversation?.endpoint?.id === 'string'
+    ? conversation.endpoint.id
+    : undefined;
+  const adapterName = String(
+    (endpointCapabilityId?.split('\0').pop() ?? endpointCapabilityId)?.split('~')[0]
+    ?? meta.adapter
+    ?? SMOKE_CHANNEL.adapterName,
+  );
+  const endpointKey = String(
+    meta.endpoint ?? meta.endpointKey ?? meta.endpoint_id ?? adapterName,
+  );
+  const senderId = String(msg.sender ?? meta.senderId ?? '');
+  const senderName = String(meta.senderName ?? meta.name ?? '');
+
+  if (!channelId) return { ...SMOKE_CHANNEL, adapterName, endpointKey, senderId, senderName };
+
+  return {
+    adapterName,
+    endpointKey,
+    channelType,
+    channelId,
+    senderId,
+    senderName,
+  };
+}

package/src/db-store.ts

@@ -0,0 +1,22 @@
+export {
+  createInMemoryRssDb,
+  RSS_SEEN_TABLE,
+  RSS_SUBS_TABLE,
+  type RssMemoryDb,
+  type RssModel,
+} from './memory-store.js';
+
+import {
+  RSS_SEEN_TABLE,
+  RSS_SUBS_TABLE,
+  type RssMemoryDb,
+  type RssModel,
+} from './memory-store.js';
+
+export function getRssSubs(db: RssMemoryDb): RssModel | null {
+  return db.models.get(RSS_SUBS_TABLE) ?? null;
+}
+
+export function getRssSeen(db: RssMemoryDb): RssModel | null {
+  return db.models.get(RSS_SEEN_TABLE) ?? null;
+}