@cloudhal/mcp-server 0.0.0-stage → 0.1.1

package/dist/src/body-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Body tools (RFC-0014 §4, ADR-0028): read a markdown body as blocks, edit it by block, and see
+ * what changed in one page or article between two versions.
+ *
+ * - `get_body` returns the blocks with their ids and hashes (and who last wrote each).
+ * - `edit_body` applies up to 50 operations in one write. A stale `rev` is rebased when every
+ *   block the operations name still exists and carries the `ifHash` the agent read; anything else
+ *   is a conflict with the current blocks to read again. Every write is snapshotted. With
+ *   `mode: "propose"` it files the operations for a person instead (any mode, `plan` included).
+ * - `diff_node` compares a node across snapshots (or with its current draft), body block by block.
+ */
+import type { ContentEntry, Page } from "@cloudhal/core-contracts";
+import { type BlockWriter } from "@cloudhal/core-ts";
+import { type ToolContext, type ToolDefinition } from "./common.js";
+/** What a body edit wrote: the new `rev`, the block ids it changed, added and removed. */
+export interface BodyEditResult {
+    rev: number;
+    changed: string[];
+    added: string[];
+    removed: string[];
+    words: {
+        added: number;
+        removed: number;
+    };
+    /** Block types the body uses that this site does not know (RFC-0015 §7). */
+    unknownBlocks?: string[];
+}
+/**
+ * Applies `a.ops` to the body `a` names (`entryId`, or `pageId` with `sectionId`) at `a.rev`, in
+ * one write as `writer` (RFC-0014 §4): `edit_body` and REST `PATCH …/body` share it. Own limits
+ * come from `ctx.limit`; snapshotting is the caller's.
+ */
+export declare function editBody(a: Record<string, unknown>, ctx: ToolContext, writer: BlockWriter): Promise<BodyEditResult>;
+export declare function bodyTools(): ToolDefinition[];
+type Node = ContentEntry | Page;
+/** Changed fields, and each markdown body's block diff (unchanged blocks without their text). */
+export declare function nodeChanges(before: Node | undefined, after: Node | undefined): {
+    fields: string[];
+    bodies: {
+        field: string;
+        counts: unknown;
+        words: unknown;
+        blocks: unknown[];
+    }[];
+};
+export {};