@stll/folio-agents/dist/bridges/reviewer.js

Framework-neutral LLM tool layer over folio's ai-edits engine: function-calling tools so an agent can read and mutate .docx documents through @stll/folio-core.

import { registerDecodedCommentHandlers } from "../bridge.js";
import { decodeCommentId } from "../codecs.js";
import { toAgentChange } from "./shared.js";
//#region src/bridges/reviewer.ts
const toAgentCommentReply = (reply) => ({
	id: String(reply.id),
	author: reply.author,
	text: reply.text
});
const toAgentComment = (comment) => ({
	id: String(comment.id),
	author: comment.author,
	text: comment.text,
	resolved: comment.done,
	blockId: comment.blockId,
	quote: comment.anchoredText,
	replies: comment.replies.map(toAgentCommentReply)
});
/**
* Build a {@link FolioAgentBridge} over a headless {@link FolioDocxReviewer}
* (`@stll/folio-core/server`). No optional capability members are
* implemented: a headless document has no live page/selection/scroll
* surface, so `read_page`, `read_selection`, and `scroll_to_block` report an
* unsupported-capability error via {@link executeFolioToolCall} on this
* bridge.
*/
const createReviewerBridge = (reviewer, options = {}) => {
	const mode = options.mode ?? "tracked-changes";
	return registerDecodedCommentHandlers({
		snapshot: () => reviewer.snapshot(),
		documentOperationMode: mode,
		applyDocumentOperations: (batch) => reviewer.applyDocumentOperations(batch.mode === void 0 ? {
			...batch,
			mode
		} : batch),
		undoDocumentOperations: (undoHandle) => reviewer.undoDocumentOperations(undoHandle),
		getComments: () => reviewer.getComments().map(toAgentComment),
		getChanges: () => reviewer.getChanges().map(toAgentChange),
		listStories: () => reviewer.listStories(),
		readStory: (handle) => reviewer.readStory(handle),
		replyToComment: (commentId, text) => {
			const decoded = decodeCommentId(commentId);
			return decoded !== null && reviewer.replyTo(decoded.numeric, { text }) !== null;
		},
		resolveComment: (commentId, resolved) => {
			const decoded = decodeCommentId(commentId);
			return decoded !== null && reviewer.resolveComment(decoded.raw, { resolved });
		}
	}, {
		replyToComment: ({ numeric }, text) => reviewer.replyTo(numeric, { text }) !== null,
		resolveComment: ({ raw }, resolved) => reviewer.resolveComment(raw, { resolved })
	});
};
//#endregion
export { createReviewerBridge };