@book.dev/sdk 1.60.0

package/dist/content.d.ts

@@ -0,0 +1,38 @@
+import type { PageSnapshot } from './types';
+/** Flatten a page snapshot (EditorJS or block-editor) into plain text. */
+export declare function snapshotText(data: PageSnapshot | null | undefined): string;
+/** Turn plain text into EditorJS paragraph blocks (one per non-empty line). */
+export declare function paragraphBlocks(content: string, idPrefix?: string): Array<{
+    id: string;
+    type: 'paragraph';
+    data: {
+        text: string;
+    };
+}>;
+/** Build a fresh page snapshot whose document is the given plain text. */
+export declare function textSnapshot(content?: string, idPrefix?: string): PageSnapshot;
+/**
+ * Append plain text to a page snapshot as paragraph blocks, returning the new
+ * snapshot — or `null` when the page can't be appended to this way (the
+ * collaborative block editor owns those documents). Used by the agent and the
+ * MCP server so both apply the same guard.
+ */
+export declare function appendTextToSnapshot(data: PageSnapshot, content: string, idPrefix?: string): PageSnapshot | null;
+/** A block to append to a block-editor page (the agent / MCP write path). */
+export interface AppendBlock {
+    type: string;
+    /** Plain text (text-carrying blocks). */
+    text?: string;
+    props?: Record<string, unknown>;
+}
+/**
+ * Append blocks to a **block-editor** page's JSON projection, returning the new
+ * snapshot — or `null` for legacy EditorJS pages (use {@link appendTextToSnapshot}
+ * there). This mutates only the JSON projection (`blockdoc.blocks`), NOT the
+ * CRDT `update` — so a *live* editor on that page should apply the change
+ * through the editor bridge instead (one CRDT transaction, undoable). This
+ * server-side path exists for the MCP server, which has no live editor; a live
+ * client merges the JSON projection on next load. Used by the agent's confirm
+ * gate only as a fallback when no editor bridge is present.
+ */
+export declare function appendBlocksToSnapshot(data: PageSnapshot, blocks: AppendBlock[], idPrefix?: string): PageSnapshot | null;

package/dist/content.js

@@ -0,0 +1,107 @@
+const stripHtml = (s) => s.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
+/** Flatten a page snapshot (EditorJS or block-editor) into plain text. */
+export function snapshotText(data) {
+    if (!data)
+        return '';
+    const parts = [];
+    // Block-editor pages: read the JSON projection.
+    const blockdoc = data.blockdoc;
+    if (data.editor === 'blocks' && blockdoc?.blocks) {
+        const walk = (blocks) => {
+            for (const b of blocks) {
+                if (Array.isArray(b.text))
+                    parts.push(b.text.map((r) => r.t).join(''));
+                if (typeof b.props?.source === 'string')
+                    parts.push(String(b.props.source));
+                if (b.children)
+                    walk(b.children);
+            }
+        };
+        walk(blockdoc.blocks);
+        return parts.join('\n').trim();
+    }
+    // EditorJS pages: pull the text-ish fields out of each block.
+    const blocks = data.editorjs?.blocks ?? [];
+    for (const b of blocks) {
+        const d = b.data ?? {};
+        if (typeof d.text === 'string')
+            parts.push(stripHtml(d.text));
+        if (typeof d.code === 'string')
+            parts.push(String(d.code));
+        if (typeof d.title === 'string')
+            parts.push(stripHtml(String(d.title)));
+        if (typeof d.content === 'string')
+            parts.push(stripHtml(String(d.content)));
+        if (Array.isArray(d.items)) {
+            for (const item of d.items) {
+                const t = typeof item === 'string' ? item : (item.text ?? item.content ?? '');
+                if (t)
+                    parts.push(stripHtml(String(t)));
+            }
+        }
+        if (Array.isArray(d.content)) {
+            for (const row of d.content) {
+                if (Array.isArray(row))
+                    parts.push(row.map((c) => stripHtml(String(c))).join(' '));
+            }
+        }
+    }
+    return parts.join('\n').trim();
+}
+/** Turn plain text into EditorJS paragraph blocks (one per non-empty line). */
+export function paragraphBlocks(content, idPrefix = 'gen') {
+    return content
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean)
+        .map((text, i) => ({ id: `${idPrefix}-${i}`, type: 'paragraph', data: { text } }));
+}
+/** Build a fresh page snapshot whose document is the given plain text. */
+export function textSnapshot(content = '', idPrefix = 'gen') {
+    return { editorjs: { blocks: paragraphBlocks(content, idPrefix) }, values: [], names: [] };
+}
+/**
+ * Append plain text to a page snapshot as paragraph blocks, returning the new
+ * snapshot — or `null` when the page can't be appended to this way (the
+ * collaborative block editor owns those documents). Used by the agent and the
+ * MCP server so both apply the same guard.
+ */
+export function appendTextToSnapshot(data, content, idPrefix = 'gen') {
+    if (data.editor === 'blocks')
+        return null;
+    const added = paragraphBlocks(content, idPrefix);
+    if (added.length === 0)
+        return data;
+    const editorjs = data.editorjs ?? { blocks: [] };
+    return { ...data, editorjs: { ...editorjs, blocks: [...(editorjs.blocks ?? []), ...added] } };
+}
+/**
+ * Append blocks to a **block-editor** page's JSON projection, returning the new
+ * snapshot — or `null` for legacy EditorJS pages (use {@link appendTextToSnapshot}
+ * there). This mutates only the JSON projection (`blockdoc.blocks`), NOT the
+ * CRDT `update` — so a *live* editor on that page should apply the change
+ * through the editor bridge instead (one CRDT transaction, undoable). This
+ * server-side path exists for the MCP server, which has no live editor; a live
+ * client merges the JSON projection on next load. Used by the agent's confirm
+ * gate only as a fallback when no editor bridge is present.
+ */
+export function appendBlocksToSnapshot(data, blocks, idPrefix = 'gen') {
+    if (data.editor !== 'blocks')
+        return null;
+    if (blocks.length === 0)
+        return data;
+    const blockdoc = data.blockdoc ?? { blocks: [] };
+    const projected = blocks.map((b, i) => ({
+        id: `${idPrefix}-${i}`,
+        type: b.type,
+        ...(b.text !== undefined ? { text: [{ t: b.text }] } : {}),
+        ...(b.props ? { props: b.props } : {}),
+    }));
+    return {
+        ...data,
+        // Drop the stale CRDT `update` so the page rebuilds from the JSON projection
+        // (decodeSnapshot prefers `update`; clearing it forces the merged blocks in).
+        blockdoc: { ...blockdoc, update: undefined, blocks: [...(blockdoc.blocks ?? []), ...projected] },
+    };
+}
+//# sourceMappingURL=content.js.map

package/dist/content.js.map

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