@cogitator-ai/channels 0.15.12 → 0.17.0

package/dist/thread-key.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+/**
+ * The conversation of a message inside its channel: its `conversationId` when the channel names
+ * one, otherwise its chat (`channelId`) and, when it has one, the topic inside it (`topicId`).
+ */
+export function conversationOf(msg) {
+    if (msg.conversationId)
+        return msg.conversationId;
+    return msg.topicId ? `${msg.channelId}:${msg.topicId}` : msg.channelId;
+}
+/**
+ * The gateway's default thread key: one thread per user per conversation,
+ * `channelType:conversation:userId` (see {@link conversationOf}). A user's private chat, each
+ * group chat and each forum topic or Slack thread they write in is a thread of its own.
+ */
+export function defaultThreadKey(msg) {
+    return `${msg.channelType}:${conversationOf(msg)}:${msg.userId}`;
+}
+/**
+ * The thread key of earlier versions: one thread per user per channel type,
+ * `channelType:userId`, whatever chat or topic the message comes from. Pass it as
+ * `session.threadKey` to keep the threads a gateway stored before the default changed.
+ */
+export function legacyThreadKey(msg) {
+    return `${msg.channelType}:${msg.userId}`;
+}
+/** The session metadata key that holds a user's conversations, most recent first */
+export const CONVERSATIONS_KEY = 'conversations';
+/** Conversations kept per session, past it the least recently used one goes */
+export const MAX_STORED_CONVERSATIONS = 50;
+const StoredConversationSchema = z.object({
+    channelId: z.string().min(1),
+    topicId: z.string().min(1).optional(),
+    conversationId: z.string().min(1).optional(),
+});
+/**
+ * The conversations stored in a session's metadata, skipping entries that are not one. Metadata
+ * a session store left out reads as none.
+ */
+export function readConversations(metadata) {
+    const stored = metadata?.[CONVERSATIONS_KEY];
+    if (!Array.isArray(stored))
+        return [];
+    const conversations = [];
+    for (const entry of stored) {
+        const parsed = StoredConversationSchema.safeParse(entry);
+        if (parsed.success)
+            conversations.push(parsed.data);
+    }
+    return conversations;
+}
+function toStored(msg) {
+    return {
+        channelId: msg.channelId,
+        ...(msg.topicId && { topicId: msg.topicId }),
+        ...(msg.conversationId && { conversationId: msg.conversationId }),
+    };
+}
+function sameEntry(a, b) {
+    return (a.channelId === b.channelId && a.topicId === b.topicId && a.conversationId === b.conversationId);
+}
+/**
+ * The conversations with the message's own moved to the front, or `null` when it is already
+ * there as it is, so nothing needs to be written. On Bluesky and Threads the entry keeps the
+ * conversation's latest post as its `channelId`.
+ */
+export function rememberConversation(conversations, msg) {
+    const entry = toStored(msg);
+    const head = conversations[0];
+    if (head && sameEntry(head, entry))
+        return null;
+    const key = conversationOf(entry);
+    return [entry, ...conversations.filter((c) => conversationOf(c) !== key)].slice(0, MAX_STORED_CONVERSATIONS);
+}
+/**
+ * The stored conversation a message sent to `channelId` without a topic most likely continues:
+ * the most recent one in that chat.
+ */
+export function findConversation(conversations, channelId) {
+    return conversations.find((c) => c.channelId === channelId);
+}
+//# sourceMappingURL=thread-key.js.map

package/dist/thread-key.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogitator-ai/channels",
-  "version": "0.15.12",
+  "version": "0.17.0",
   "description": "Messaging channel connectors and Gateway for Cogitator AI agents",
   "keywords": [
     "cogitator",
@@ -17,6 +17,8 @@
     "streaming",
     "bluesky",
     "threads",
+    "github",
+    "email",
     "social"
   ],
   "type": "module",
@@ -34,9 +36,9 @@
     "dist"
   ],
   "dependencies": {
-    "@cogitator-ai/core": "0.59.0",
-    "@cogitator-ai/memory": "0.25.0",
-    "@cogitator-ai/types": "0.64.0",
+    "@cogitator-ai/core": "0.60.1",
+    "@cogitator-ai/memory": "0.25.2",
+    "@cogitator-ai/types": "0.66.0",
     "cron-parser": "^5.10.1",
     "nanoid": "^6.0.1",
     "zod": "^4.6.5"
@@ -44,18 +46,22 @@
   "devDependencies": {
     "@atproto/api": "0.24.0",
     "@types/node": "^22.20.4",
+    "@types/nodemailer": "^8.0.2",
     "@types/ws": "^8.18.2",
     "@whiskeysockets/baileys": "7.0.0-rc14",
     "better-sqlite3": "^13.0.3",
+    "imapflow": "^2.7.0",
+    "nodemailer": "^10.0.13",
+    "postal-mime": "^4.1.2",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3",
     "ws": "^8.22.0"
   },
   "peerDependencies": {
-    "@cogitator-ai/browser": ">=0.4.40",
-    "@cogitator-ai/mcp": "^19.5.22",
+    "@cogitator-ai/browser": ">=0.4.42",
+    "@cogitator-ai/mcp": "^19.5.24",
     "@cogitator-ai/models": "^18.5.0",
-    "@cogitator-ai/rag": ">=0.8.14",
+    "@cogitator-ai/rag": ">=0.8.16",
     "@huggingface/transformers": ">=3.0.0",
     "@slack/bolt": ">=3.0.0",
     "@whiskeysockets/baileys": "^6.0.0 || >=7.0.0-0",
@@ -66,7 +72,10 @@
     "pg": ">=8.0.0",
     "qrcode-terminal": ">=0.12.0",
     "ws": ">=8.0.0",
-    "@atproto/api": ">=0.24.0"
+    "@atproto/api": ">=0.24.0",
+    "imapflow": ">=2.0.0",
+    "nodemailer": "^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0 || ^10.0.0",
+    "postal-mime": ">=4.0.0"
   },
   "peerDependenciesMeta": {
     "grammy": {
@@ -113,6 +122,15 @@
     },
     "@atproto/api": {
       "optional": true
+    },
+    "imapflow": {
+      "optional": true
+    },
+    "nodemailer": {
+      "optional": true
+    },
+    "postal-mime": {
+      "optional": true
     }
   },
   "engines": {