merlyn/server/utils/agents/aibitat/plugins/outlook/search/outlook-read-thread.js
2026-04-15 10:05:26 -07:00

132 lines
4.9 KiB
JavaScript

const outlookLib = require("../lib.js");
const { handleAttachments, handleSkillError } = outlookLib;
module.exports.OutlookReadThread = {
name: "outlook-read-thread",
plugin: function () {
return {
name: "outlook-read-thread",
setup(aibitat) {
aibitat.function({
super: aibitat,
name: this.name,
description:
"Read a full email conversation thread by its conversation ID. " +
"Returns all messages in the thread including sender, recipients, subject, body, date, and attachment information. " +
"Use this after searching to read the full conversation.",
examples: [
{
prompt: "Read the email thread with conversation ID AAQkAGI2...",
call: JSON.stringify({
conversationId: "AAQkAGI2...",
}),
},
],
parameters: {
$schema: "http://json-schema.org/draft-07/schema#",
type: "object",
properties: {
conversationId: {
type: "string",
description: "The Outlook conversation ID to read.",
},
},
required: ["conversationId"],
additionalProperties: false,
},
handler: async function ({ conversationId }) {
try {
this.super.handlerProps.log(
`Using the outlook-read-thread tool.`
);
if (!conversationId) {
return "Error: conversationId is required.";
}
this.super.introspect(
`${this.caller}: Reading Outlook conversation...`
);
const result = await outlookLib.readThread(conversationId);
if (!result.success) {
this.super.introspect(
`${this.caller}: Failed to read thread - ${result.error}`
);
return `Error reading Outlook thread: ${result.error}`;
}
const thread = result.data;
const { allAttachments, parsedContent: parsedAttachmentContent } =
await handleAttachments(this, thread.messages);
const messagesFormatted = thread.messages
.map((msg, i) => {
let attachmentInfo = "";
if (msg.attachments?.length > 0) {
attachmentInfo = `\n Attachments: ${msg.attachments.map((a) => `${a.name} (${a.contentType}, ${(a.size / 1024).toFixed(1)}KB)`).join(", ")}`;
}
const bodyContent =
msg.bodyType === "html"
? msg.body
.replace(/<[^>]*>/g, " ")
.replace(/\s+/g, " ")
.trim()
: msg.body;
return (
`--- Message ${i + 1} ---\n` +
`From: ${msg.fromName} <${msg.from}>\n` +
`To: ${msg.to}\n` +
(msg.cc ? `CC: ${msg.cc}\n` : "") +
`Date: ${new Date(msg.date).toLocaleString()}\n` +
`Subject: ${msg.subject}\n` +
`Status: ${msg.isRead ? "READ" : "UNREAD"}\n` +
`\n${bodyContent}` +
attachmentInfo
);
})
.join("\n\n");
this.super.introspect(
`${this.caller}: Successfully read thread with ${thread.messageCount} messages`
);
// Report citation for the thread (without attachments)
this.super.addCitation?.({
id: `outlook-thread-${thread.conversationId}`,
title: thread.subject,
text: `Subject: "${thread.subject}"\n\n${messagesFormatted}`,
chunkSource: `outlook-thread://${this._generatePermalink(thread.conversationId)}`,
score: null,
});
return (
`Thread: "${thread.subject}"\n` +
`Conversation ID: ${thread.conversationId}\n` +
`Messages: ${thread.messageCount}\n` +
`Total Attachments: ${allAttachments.length}\n\n` +
messagesFormatted +
parsedAttachmentContent
);
} catch (e) {
return handleSkillError(this, "outlook-read-thread", e);
}
},
_generatePermalink: function (conversationId) {
if (!conversationId) return null;
let encodedId = encodeURIComponent(conversationId);
// For outlook, this needs to be specifically encoded
// as the webpage does not respect it like traditional URL encoding
encodedId = encodedId.replace(/-/g, "%2F");
return `https://outlook.live.com/mail/inbox/id/${encodedId}`;
},
});
},
};
},
};