@stll/folio-agents/dist/codecs.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 { FOLIO_TEXT_RANGE_JSON_SCHEMA } from "./operation-schema.js";
//#region src/codecs.ts
const NORMALIZED_TEXT_HASH_PATTERN = /^h[0-9a-z]+$/;
const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
const isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
const FOLIO_STORY_HANDLE_JSON_SCHEMA = {
	type: "object",
	properties: {
		type: {
			type: "string",
			enum: [
				"main",
				"header",
				"footer",
				"footnote",
				"endnote"
			]
		},
		relationshipId: { type: "string" },
		noteId: { type: "integer" }
	},
	required: ["type"],
	additionalProperties: false
};
const FOLIO_SECTION_HANDLE_JSON_SCHEMA = {
	type: "object",
	properties: {
		type: {
			type: "string",
			enum: ["headingSection"]
		},
		story: {
			type: "string",
			enum: ["main"]
		},
		headingBlockId: { type: "string" },
		headingTextHash: { type: "string" },
		headingLevel: {
			type: "integer",
			minimum: 1,
			maximum: 9
		}
	},
	required: [
		"type",
		"story",
		"headingBlockId",
		"headingTextHash",
		"headingLevel"
	],
	additionalProperties: false
};
const FOLIO_SCOPED_HANDLE_JSON_SCHEMA = {
	type: "object",
	properties: {
		type: {
			type: "string",
			enum: [
				"main",
				"header",
				"footer",
				"footnote",
				"endnote",
				"headingSection"
			]
		},
		story: {
			type: "string",
			enum: ["main"]
		},
		relationshipId: { type: "string" },
		noteId: { type: "integer" },
		headingBlockId: { type: "string" },
		headingTextHash: { type: "string" },
		headingLevel: {
			type: "integer",
			minimum: 1,
			maximum: 9
		}
	},
	required: ["type"],
	additionalProperties: false
};
const FOLIO_COMMENT_ID_JSON_SCHEMA = {
	type: "string",
	description: "The comment id string from `read_comments`."
};
const decodeSectionHandle = (value) => {
	if (!isPlainObject(value)) return null;
	const headingBlockId = value["headingBlockId"];
	const headingTextHash = value["headingTextHash"];
	const headingLevel = value["headingLevel"];
	if (value["type"] !== "headingSection" || value["story"] !== "main" || !isNonEmptyString(headingBlockId) || !isNonEmptyString(headingTextHash) || !NORMALIZED_TEXT_HASH_PATTERN.test(headingTextHash) || typeof headingLevel !== "number" || !Number.isInteger(headingLevel) || headingLevel < 1 || headingLevel > 9) return null;
	return {
		type: "headingSection",
		story: "main",
		headingBlockId,
		headingTextHash,
		headingLevel
	};
};
const decodeStoryHandle = (value) => {
	if (!isPlainObject(value)) return null;
	const type = value["type"];
	if (type === "main") return { type };
	if (type === "header" || type === "footer") {
		const relationshipId = value["relationshipId"];
		if (!isNonEmptyString(relationshipId)) return null;
		return {
			type,
			relationshipId
		};
	}
	if (type === "footnote" || type === "endnote") {
		const noteId = value["noteId"];
		if (typeof noteId !== "number" || !Number.isInteger(noteId)) return null;
		return {
			type,
			noteId
		};
	}
	return null;
};
const decodeMainStoryTextRangeHandle = (value) => {
	if (!isPlainObject(value)) return null;
	const blockId = value["blockId"];
	const startOffset = value["startOffset"];
	const endOffset = value["endOffset"];
	const selectedTextHash = value["selectedTextHash"];
	if (value["type"] !== "textRange" || value["story"] !== "main" || !isNonEmptyString(blockId) || typeof startOffset !== "number" || !Number.isInteger(startOffset) || startOffset < 0 || typeof endOffset !== "number" || !Number.isInteger(endOffset) || endOffset <= startOffset || !isNonEmptyString(selectedTextHash) || !NORMALIZED_TEXT_HASH_PATTERN.test(selectedTextHash)) return null;
	return {
		type: "textRange",
		story: "main",
		blockId,
		startOffset,
		endOffset,
		selectedTextHash
	};
};
const decodeCommentId = (value) => {
	if (typeof value !== "string" || !/^\d+$/u.test(value)) return null;
	const numeric = Number(value);
	if (!Number.isSafeInteger(numeric)) return null;
	return {
		raw: value,
		numeric
	};
};
//#endregion
export { FOLIO_COMMENT_ID_JSON_SCHEMA, FOLIO_SCOPED_HANDLE_JSON_SCHEMA, FOLIO_SECTION_HANDLE_JSON_SCHEMA, FOLIO_STORY_HANDLE_JSON_SCHEMA, FOLIO_TEXT_RANGE_JSON_SCHEMA, decodeCommentId, decodeMainStoryTextRangeHandle, decodeSectionHandle, decodeStoryHandle };