@book.dev/sdk 3.16.0 → 3.17.0

package/dist/pageTools.js

@@ -0,0 +1,175 @@
+import { BACKLINKS_PROPERTY_ID, COVER_PROPERTY_ID, FULLWIDTH_PROPERTY_ID, ICON_PROPERTY_ID, OWNER_PROPERTY_ID, THEME_PROPERTY_ID, VERIFICATION_PROPERTY_ID, } from './pageProperties';
+export const PAGE_THEME_IDS = [
+    'default', 'amber', 'forest', 'graphite', 'ocean', 'rose', 'sandstone', 'slate', 'sunset', 'teal', 'violet',
+];
+export const PAGE_BACKGROUND_TOKENS = ['gray', 'red', 'orange', 'yellow', 'green', 'blue', 'purple', 'pink'];
+export const PAGE_COVER_GRADIENT_IDS = ['dawn', 'ocean', 'dusk', 'forest', 'ember', 'slate', 'citrus', 'mint', 'grape', 'sand', 'rose', 'night'];
+export const COVER_GRADIENTS = [
+    { id: 'dawn', css: 'linear-gradient(120deg, #f6d365 0%, #fda085 100%)' },
+    { id: 'ocean', css: 'linear-gradient(120deg, #4facfe 0%, #00f2fe 100%)' },
+    { id: 'dusk', css: 'linear-gradient(120deg, #a18cd1 0%, #fbc2eb 100%)' },
+    { id: 'forest', css: 'linear-gradient(120deg, #0ba360 0%, #3cba92 100%)' },
+    { id: 'ember', css: 'linear-gradient(120deg, #ff6a88 0%, #ff99ac 60%, #ffc3a0 100%)' },
+    { id: 'slate', css: 'linear-gradient(120deg, #2b5876 0%, #4e4376 100%)' },
+    { id: 'citrus', css: 'linear-gradient(120deg, #f7971e 0%, #ffd200 100%)' },
+    { id: 'mint', css: 'linear-gradient(120deg, #43e97b 0%, #38f9d7 100%)' },
+    { id: 'grape', css: 'linear-gradient(120deg, #667eea 0%, #764ba2 100%)' },
+    { id: 'sand', css: 'linear-gradient(120deg, #e6dada 0%, #d3a17b 100%)' },
+    { id: 'rose', css: 'linear-gradient(120deg, #ee9ca7 0%, #ffdde1 100%)' },
+    { id: 'night', css: 'linear-gradient(120deg, #232526 0%, #414345 100%)' },
+];
+export class PageToolError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'PageToolError';
+    }
+}
+const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null;
+const oneOf = (value, values) => typeof value === 'string' && values.includes(value);
+/** Validate and project the public appearance input onto reserved page-property ids. */
+export function buildPageAppearancePatch(input) {
+    const patch = {};
+    if (input.icon !== undefined) {
+        if (input.icon !== null && (typeof input.icon !== 'string' || input.icon.length > 32))
+            throw new PageToolError('invalid_input', 'icon must be a string of at most 32 characters or null.');
+        patch[ICON_PROPERTY_ID] = input.icon;
+    }
+    if (input.fullWidth !== undefined) {
+        if (input.fullWidth !== null && typeof input.fullWidth !== 'boolean')
+            throw new PageToolError('invalid_input', 'fullWidth must be a boolean or null.');
+        patch[FULLWIDTH_PROPERTY_ID] = input.fullWidth;
+    }
+    if (input.theme !== undefined) {
+        if (input.theme === null)
+            patch[THEME_PROPERTY_ID] = null;
+        else {
+            const theme = record(input.theme);
+            if (!theme)
+                throw new PageToolError('invalid_input', 'theme must be an object or null.');
+            const allowed = new Set(['themeId', 'background', 'controlIntensity', 'interfaceIntensity']);
+            if (Object.keys(theme).some((key) => !allowed.has(key)))
+                throw new PageToolError('invalid_input', 'theme contains an unknown setting.');
+            if (theme.themeId !== undefined && !oneOf(theme.themeId, PAGE_THEME_IDS))
+                throw new PageToolError('invalid_input', `Unknown theme "${String(theme.themeId)}".`);
+            if (theme.background !== undefined && !oneOf(theme.background, PAGE_BACKGROUND_TOKENS))
+                throw new PageToolError('invalid_input', `Unknown background "${String(theme.background)}".`);
+            for (const key of ['controlIntensity', 'interfaceIntensity']) {
+                if (theme[key] !== undefined && (!Number.isInteger(theme[key]) || Number(theme[key]) < 0 || Number(theme[key]) > 3))
+                    throw new PageToolError('invalid_input', `${key} must be an integer from 0 to 3.`);
+            }
+            patch[THEME_PROPERTY_ID] = theme;
+        }
+    }
+    if (input.cover !== undefined) {
+        if (input.cover === null)
+            patch[COVER_PROPERTY_ID] = null;
+        else {
+            const cover = record(input.cover);
+            if (!cover || (cover.kind !== 'gradient' && cover.kind !== 'image'))
+                throw new PageToolError('invalid_input', 'cover must be a gradient or image cover.');
+            const allowed = cover.kind === 'gradient' ? new Set(['kind', 'gradientId']) : new Set(['kind', 'url', 'position']);
+            if (Object.keys(cover).some((key) => !allowed.has(key)))
+                throw new PageToolError('invalid_input', 'cover contains an unknown setting.');
+            if (cover.kind === 'gradient' && !oneOf(cover.gradientId, PAGE_COVER_GRADIENT_IDS))
+                throw new PageToolError('invalid_input', 'A gradient cover requires a valid gradientId.');
+            if (cover.kind === 'image' && (typeof cover.url !== 'string' || (!/^https:\/\//i.test(cover.url) && !cover.url.startsWith('/api/assets/')))) {
+                throw new PageToolError('invalid_input', 'cover.url must be https or an OpenBook asset URL');
+            }
+            if (cover.position !== undefined && (typeof cover.position !== 'number' || cover.position < 0 || cover.position > 1))
+                throw new PageToolError('invalid_input', 'cover.position must be between 0 and 1.');
+            patch[COVER_PROPERTY_ID] = cover.kind === 'gradient'
+                ? { kind: 'gradient', css: COVER_GRADIENTS.find(({ id }) => id === cover.gradientId).css }
+                : cover;
+        }
+    }
+    if (Object.keys(patch).length === 0)
+        throw new PageToolError('invalid_input', 'Pass at least one appearance setting.');
+    return patch;
+}
+export function validatePageProperties(input) {
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (key === BACKLINKS_PROPERTY_ID)
+            throw new PageToolError('invalid_input', 'Backlinks are computed and cannot be set.');
+        if (key === OWNER_PROPERTY_ID) {
+            if (value !== null && typeof value !== 'string')
+                throw new PageToolError('invalid_input', 'sys_owner must be a string or null.');
+        }
+        else if (key === VERIFICATION_PROPERTY_ID) {
+            if (value !== null) {
+                const v = record(value);
+                if (!v || typeof v.verified !== 'boolean' || ['by', 'at', 'expiresAt'].some((field) => v[field] !== undefined && v[field] !== null && typeof v[field] !== 'string')) {
+                    throw new PageToolError('invalid_input', 'sys_verification has an invalid value.');
+                }
+            }
+        }
+        else {
+            throw new PageToolError('invalid_input', `Unknown page property "${key}".`);
+        }
+        out[key] = value;
+    }
+    if (Object.keys(out).length === 0)
+        throw new PageToolError('invalid_input', 'Pass at least one page property.');
+    return out;
+}
+const page = async (store, pageId) => {
+    const found = await store.getPage(pageId);
+    if (!found)
+        throw new PageToolError('page_not_found', 'Page not found.');
+    return found;
+};
+export async function setPageAppearanceTool(store, pageId, input) {
+    await page(store, pageId);
+    const updated = await store.setPageProperties(pageId, buildPageAppearancePatch(input));
+    if (!updated)
+        throw new PageToolError('page_not_found', 'Page not found.');
+    return updated;
+}
+export async function getPagePropertiesTool(store, pageId) {
+    return (await page(store, pageId)).properties ?? {};
+}
+export async function setPagePropertiesTool(store, pageId, properties) {
+    await page(store, pageId);
+    const updated = await store.setPageProperties(pageId, validatePageProperties(properties));
+    if (!updated)
+        throw new PageToolError('page_not_found', 'Page not found.');
+    return updated;
+}
+/** Validate a page move and compute the ordered destination siblings without writing. */
+export function buildMovePlan(pages, input) {
+    if (!pages.some((candidate) => candidate.id === input.pageId))
+        throw new PageToolError('page_not_found', 'Page not found.');
+    if (input.parentId === input.pageId)
+        throw new PageToolError('invalid_move', 'A page cannot be its own parent.');
+    if (input.parentId !== null && !pages.some((candidate) => candidate.id === input.parentId))
+        throw new PageToolError('parent_not_found', 'Parent page not found.');
+    const byId = new Map(pages.map((candidate) => [candidate.id, candidate]));
+    for (let ancestor = input.parentId; ancestor !== null; ancestor = byId.get(ancestor)?.parentId ?? null) {
+        if (ancestor === input.pageId)
+            throw new PageToolError('invalid_move', 'The move would create a cycle.');
+    }
+    const siblings = pages.filter((candidate) => candidate.id !== input.pageId && (candidate.parentId ?? null) === input.parentId).map(({ id }) => id);
+    if (input.position && 'afterId' in input.position) {
+        const at = siblings.indexOf(input.position.afterId);
+        if (at < 0)
+            throw new PageToolError('invalid_input', 'afterId must name a sibling under the destination parent.');
+        siblings.splice(at + 1, 0, input.pageId);
+    }
+    else {
+        const index = input.position && 'index' in input.position ? input.position.index : siblings.length;
+        if (!Number.isInteger(index) || index < 0 || index > siblings.length)
+            throw new PageToolError('invalid_input', 'position.index is outside the destination sibling range.');
+        siblings.splice(index, 0, input.pageId);
+    }
+    return { parentId: input.parentId, orderedIds: siblings };
+}
+export async function movePageTool(store, input) {
+    await page(store, input.pageId);
+    const move = buildMovePlan(await store.listPages(), input);
+    const moved = await store.movePage(input.pageId, move);
+    if (!moved)
+        throw new PageToolError('invalid_move', 'The move was refused.');
+    return moved;
+}
+//# sourceMappingURL=pageTools.js.map

package/dist/pageTools.js.map

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

package/dist/richTextInput.d.ts

@@ -0,0 +1,29 @@
+/** Inline attributes supported by agent/MCP rich-text input. */
+export interface RunAttrs extends Record<string, unknown> {
+    b?: true;
+    i?: true;
+    u?: true;
+    s?: true;
+    c?: true;
+    a?: string;
+}
+/** The editor's JSON-projection run shape. */
+export interface Run {
+    t: string;
+    a?: RunAttrs;
+}
+export type RichTextInput = string | {
+    runs: Run[];
+};
+export type RichTextInputErrorCode = 'invalid-runs' | 'unsafe-link';
+/** A machine-readable rich-text validation failure. */
+export declare class RichTextInputError extends Error {
+    readonly code: RichTextInputErrorCode;
+    constructor(code: RichTextInputErrorCode, message: string);
+}
+/** Validate, copy, and coalesce editor-projection runs supplied by a client. */
+export declare function normalizeRuns(input: unknown): Run[];
+/** Parse the deliberately small, DOM-free markdown subset accepted by write tools. */
+export declare function parseMiniMarkdown(text: string): Run[];
+/** Resolve either mini-markdown/plain text or an explicit run envelope. */
+export declare function richTextRuns(input: RichTextInput, plain?: boolean): Run[];

package/dist/richTextInput.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { isSafeHref } from './bookfile';
+/** A machine-readable rich-text validation failure. */
+export class RichTextInputError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'RichTextInputError';
+    }
+}
+const attrsSchema = z.object({
+    b: z.literal(true).optional(),
+    i: z.literal(true).optional(),
+    u: z.literal(true).optional(),
+    s: z.literal(true).optional(),
+    c: z.literal(true).optional(),
+    a: z.string().optional(),
+}).strict();
+const runSchema = z.object({ t: z.string(), a: attrsSchema.optional() }).strict();
+const safeLink = (href) => href.trim() !== '' && isSafeHref(href);
+const sameAttrs = (a, b) => JSON.stringify(a ?? {}) === JSON.stringify(b ?? {});
+/** Validate, copy, and coalesce editor-projection runs supplied by a client. */
+export function normalizeRuns(input) {
+    const parsed = z.array(runSchema).safeParse(input);
+    if (!parsed.success) {
+        throw new RichTextInputError('invalid-runs', `Invalid rich-text runs: ${parsed.error.issues.map((issue) => issue.message).join('; ')}`);
+    }
+    const out = [];
+    for (const raw of parsed.data) {
+        if (raw.a?.a && !safeLink(raw.a.a)) {
+            throw new RichTextInputError('unsafe-link', `Unsafe link scheme in "${raw.a.a}"; use https, http, or mailto.`);
+        }
+        if (!raw.t)
+            continue;
+        const attrs = raw.a && Object.keys(raw.a).length > 0 ? raw.a : undefined;
+        const run = attrs ? { t: raw.t, a: attrs } : { t: raw.t };
+        const previous = out[out.length - 1];
+        if (previous && sameAttrs(previous.a, run.a))
+            previous.t += run.t;
+        else
+            out.push(run);
+    }
+    return out;
+}
+const MARKERS = [
+    { token: '**', attr: 'b' },
+    { token: '~~', attr: 's' },
+    { token: '`', attr: 'c' },
+    { token: '*', attr: 'i' },
+    { token: '_', attr: 'i' },
+];
+const closingAt = (text, token, from) => {
+    for (let i = from; i <= text.length - token.length; i += 1) {
+        if (text[i] === '\\') {
+            i += 1;
+            continue;
+        }
+        // In `**bold *italic***`, the first star in the closing triple belongs to
+        // the inner italic span; the final two close the outer bold span.
+        if (token === '**' && text.startsWith('***', i))
+            return i + 1;
+        if (token === '_' && /[\p{L}\p{N}]/u.test(text[i + token.length] ?? ''))
+            continue;
+        if (text.startsWith(token, i))
+            return i;
+    }
+    return -1;
+};
+const withAttr = (runs, attr, value) => runs.map((run) => ({ ...run, a: { ...run.a, [attr]: value } }));
+const parseRange = (source) => {
+    const runs = [];
+    let literal = '';
+    const flush = () => {
+        if (literal)
+            runs.push({ t: literal });
+        literal = '';
+    };
+    for (let i = 0; i < source.length;) {
+        if (source[i] === '\\' && i + 1 < source.length && /[\\*_[\]()`~]/.test(source[i + 1])) {
+            literal += source[i + 1];
+            i += 2;
+            continue;
+        }
+        if (source[i] === '[') {
+            const labelEnd = closingAt(source, ']', i + 1);
+            if (labelEnd >= 0 && source[labelEnd + 1] === '(') {
+                const urlEnd = closingAt(source, ')', labelEnd + 2);
+                if (urlEnd >= 0) {
+                    let href = source.slice(labelEnd + 2, urlEnd).trim();
+                    const title = /\s+(?:"[^"]*"|'[^']*')$/.exec(href);
+                    if (title)
+                        href = href.slice(0, title.index).trim();
+                    if (safeLink(href) && !/\s/u.test(href)) {
+                        flush();
+                        runs.push(...withAttr(parseRange(source.slice(i + 1, labelEnd)), 'a', href));
+                        i = urlEnd + 1;
+                        continue;
+                    }
+                    if (/^[a-z][a-z0-9+.-]*:/iu.test(href)) {
+                        throw new RichTextInputError('unsafe-link', `Unsafe link scheme in "${href}"; use https, http, or mailto.`);
+                    }
+                }
+            }
+        }
+        if (source[i] === '_' && (source[i - 1] === '_' || source[i + 1] === '_')) {
+            literal += source[i];
+            i += 1;
+            continue;
+        }
+        const leftOk = i === 0 || !/[\p{L}\p{N}]/u.test(source[i - 1]);
+        const marker = MARKERS.find(({ token }) => source.startsWith(token, i) && (token !== '_' || leftOk));
+        if (marker) {
+            const end = closingAt(source, marker.token, i + marker.token.length);
+            if (end >= 0 && end > i + marker.token.length) {
+                flush();
+                if (marker.token === '`') {
+                    runs.push({ t: source.slice(i + 1, end), a: { c: true } });
+                    i = end + 1;
+                    continue;
+                }
+                runs.push(...withAttr(parseRange(source.slice(i + marker.token.length, end)), marker.attr, true));
+                i = end + marker.token.length;
+                continue;
+            }
+        }
+        literal += source[i];
+        i += 1;
+    }
+    flush();
+    return normalizeRuns(runs);
+};
+/** Parse the deliberately small, DOM-free markdown subset accepted by write tools. */
+export function parseMiniMarkdown(text) {
+    return text ? parseRange(text) : [];
+}
+/** Resolve either mini-markdown/plain text or an explicit run envelope. */
+export function richTextRuns(input, plain = false) {
+    if (typeof input === 'string')
+        return plain ? (input ? [{ t: input }] : []) : parseMiniMarkdown(input);
+    return normalizeRuns(input.runs);
+}
+//# sourceMappingURL=richTextInput.js.map

package/dist/richTextInput.js.map

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

package/dist/suggestions.d.ts

@@ -62,7 +62,7 @@ export interface AuthoredIdentity {
  * them into ten kinds would buy the reviewer nothing and force every
  * `Record<SuggestionKind, …>` in the UI to grow ten entries.
  */
-export type SuggestionKind = 'replace-text' | 'set-cell' | 'insert' | 'delete' | 'set-theme' | 'table-op';
+export type SuggestionKind = 'replace-text' | 'set-cell' | 'insert' | 'move' | 'delete' | 'set-theme' | 'table-op' | 'database-op' | 'page-op';
 /** Lifecycle of a suggestion. */
 export type SuggestionStatus = 'open' | 'accepted' | 'rejected';
 /**

package/dist/tableSnapshot.d.ts

@@ -37,10 +37,13 @@
  * the projection.
  */
 import type { PageSnapshot } from './types';
+import { type RichTextInput } from './richTextInput';
 /** Prefix of the column-registry entries in a table block's props. */
 export declare const TABLE_COL_PREFIX = "col:";
 /** Prefix of the per-column colour entries (`colbg:<colId>` → palette token). */
 export declare const TABLE_COLBG_PREFIX = "colbg:";
+export declare const TABLE_COLW_PREFIX = "colw:";
+export declare const TABLE_COLUMN_MIN_WIDTH = 48;
 /**
  * The table order-contract PRIVATE keys (TBL-1): `row.props.ord`,
  * `cell.props.col`, the `col:<id>` column registry, and the `colbg:<id>`
@@ -71,7 +74,7 @@ export interface SnapshotBlock {
  * The structural table ops, named exactly as the agent proposal kinds and the
  * MCP tool names — one vocabulary across the editor bridge, the agent, and MCP.
  */
-export type TableOpKind = 'table_insert_row' | 'table_delete_row' | 'table_duplicate_row' | 'table_insert_column' | 'table_delete_column' | 'table_move_row' | 'table_move_column' | 'table_set_cell' | 'table_set_row_color' | 'table_set_column_color';
+export type TableOpKind = 'table_insert_row' | 'table_delete_row' | 'table_duplicate_row' | 'table_insert_column' | 'table_delete_column' | 'table_move_row' | 'table_move_column' | 'table_set_cell' | 'table_set_row_color' | 'table_set_column_color' | 'table_set_column_width';
 /** Every {@link TableOpKind}, for schema/description generation. */
 export declare const TABLE_OP_KINDS: readonly TableOpKind[];
 /**
@@ -89,10 +92,13 @@ export interface TableOpRequest {
     colIndex?: number;
     /** Move target, a sorted index counted with the moved row/column REMOVED. */
     toIndex?: number;
-    /** New plain text (`table_set_cell`). */
-    text?: string;
+    /** New rich text (`table_set_cell`). */
+    text?: RichTextInput;
+    plain?: boolean;
     /** Palette token, or null to clear (`table_set_row_color` / `..._column_color`). */
     color?: string | null;
+    /** Integer pixel width, or null for auto (`table_set_column_width`). */
+    width?: number | null;
 }
 /** The dimensions an op is validated against (from the SORTED grid). */
 export interface TableShape {
@@ -188,8 +194,10 @@ export interface TableOpAddress {
     rowId?: string;
     /** A column id (from `col:<id>` / a cell's `col` prop) — resolves `colIndex`. */
     colId?: string;
-    text?: string;
+    text?: RichTextInput;
+    plain?: boolean;
     color?: string | null;
+    width?: number | null;
 }
 /**
  * Resolve id-based addressing to SORTED indices against a table view. An id that

package/dist/tableSnapshot.js

@@ -38,10 +38,13 @@
  */
 import { shortId } from './database';
 import { isOrderKey, keyBetween, keysBetween, ORDER_KEY_REBALANCE_LENGTH } from './orderKeys';
+import { richTextRuns } from './richTextInput';
 /** Prefix of the column-registry entries in a table block's props. */
 export const TABLE_COL_PREFIX = 'col:';
 /** Prefix of the per-column colour entries (`colbg:<colId>` → palette token). */
 export const TABLE_COLBG_PREFIX = 'colbg:';
+export const TABLE_COLW_PREFIX = 'colw:';
+export const TABLE_COLUMN_MIN_WIDTH = 48;
 /**
  * The table order-contract PRIVATE keys (TBL-1): `row.props.ord`,
  * `cell.props.col`, the `col:<id>` column registry, and the `colbg:<id>`
@@ -53,7 +56,7 @@ export const TABLE_COLBG_PREFIX = 'colbg:';
  * none.
  */
 export function tableOrderContractKey(props) {
-    return (Object.keys(props).find((k) => k === 'ord' || k === 'col' || k.startsWith(TABLE_COL_PREFIX) || k.startsWith(TABLE_COLBG_PREFIX)) ?? null);
+    return (Object.keys(props).find((k) => k === 'ord' || k === 'col' || k.startsWith(TABLE_COL_PREFIX) || k.startsWith(TABLE_COLBG_PREFIX) || k.startsWith(TABLE_COLW_PREFIX)) ?? null);
 }
 /** The shared refusal message for a {@link tableOrderContractKey} hit — the
  *  SAME wording on both write surfaces, naming the table tools that own the
@@ -71,6 +74,7 @@ export const TABLE_OP_KINDS = [
     'table_set_cell',
     'table_set_row_color',
     'table_set_column_color',
+    'table_set_column_width',
 ];
 const ordinal = (n) => `${n}`;
 /**
@@ -116,6 +120,14 @@ export function tableOpError(shape, op) {
         case 'table_delete_column':
         case 'table_set_column_color':
             return int(op.colIndex, 'colIndex') ?? inRange(op.colIndex, 'colIndex', cols - 1);
+        case 'table_set_column_width': {
+            const bad = int(op.colIndex, 'colIndex') ?? inRange(op.colIndex, 'colIndex', cols - 1);
+            if (bad)
+                return bad;
+            return op.width === null || (typeof op.width === 'number' && Number.isInteger(op.width) && op.width >= TABLE_COLUMN_MIN_WIDTH)
+                ? null
+                : `width must be null or an integer at least ${TABLE_COLUMN_MIN_WIDTH}.`;
+        }
         case 'table_move_row': {
             const bad = int(op.rowIndex, 'rowIndex') ??
                 inRange(op.rowIndex, 'rowIndex', rows - 1) ??
@@ -135,7 +147,15 @@ export function tableOpError(shape, op) {
                 inRange(op.colIndex, 'colIndex', cols - 1);
             if (bad)
                 return bad;
-            return typeof op.text === 'string' ? null : 'text must be a string.';
+            try {
+                if (op.text === undefined)
+                    return 'text must be a string or {runs: Run[]}.';
+                richTextRuns(op.text, op.plain);
+                return null;
+            }
+            catch (error) {
+                return error instanceof Error ? error.message : String(error);
+            }
         }
         default:
             return `Unknown table op "${String(op.kind)}".`;
@@ -433,6 +453,8 @@ export function resolveTableOp(view, kind, address) {
         op.text = address.text;
     if (address.color !== undefined)
         op.color = address.color;
+    if (address.width !== undefined)
+        op.width = address.width;
     const positional = kind === 'table_insert_row' || kind === 'table_insert_column';
     if (address.cellId !== undefined) {
         let foundRow = -1;
@@ -579,6 +601,7 @@ export function applyTableOpToSnapshot(data, tableId, op) {
             }
             setProp(table, TABLE_COL_PREFIX + grid.colIds[at], undefined);
             setProp(table, TABLE_COLBG_PREFIX + grid.colIds[at], undefined);
+            setProp(table, TABLE_COLW_PREFIX + grid.colIds[at], undefined);
             grid.rows.forEach((row, r) => {
                 const cell = grid.cells[r][at];
                 if (!cell)
@@ -629,6 +652,7 @@ export function applyTableOpToSnapshot(data, tableId, op) {
             // the same trade the snapshot `update_block` path makes (a JSON projection
             // has no cursor or diff to preserve marks against; the live-editor path's
             // `replaceText` splices minimally and does keep marks on unchanged ends).
+            const runs = richTextRuns(op.text ?? '', op.plain);
             const cell = grid.cells[op.rowIndex ?? 0]?.[op.colIndex ?? 0];
             // A merge gap has no cell node — materialize one bound to that column, so
             // set_cell can fill a ragged/legacy table instead of failing on a hole.
@@ -636,10 +660,10 @@ export function applyTableOpToSnapshot(data, tableId, op) {
                 const row = grid.rows[op.rowIndex ?? 0];
                 const colId = grid.colIds[op.colIndex ?? 0];
                 if (row && colId)
-                    kids(row).push({ ...newCell(colId), text: [{ t: op.text ?? '' }] });
+                    kids(row).push({ ...newCell(colId), text: runs });
                 break;
             }
-            cell.text = [{ t: op.text ?? '' }];
+            cell.text = runs;
             break;
         }
         case 'table_set_row_color': {
@@ -654,6 +678,12 @@ export function applyTableOpToSnapshot(data, tableId, op) {
                 setProp(table, TABLE_COLBG_PREFIX + colId, op.color ?? undefined);
             break;
         }
+        case 'table_set_column_width': {
+            const colId = grid.colIds[op.colIndex ?? 0];
+            if (colId)
+                setProp(table, TABLE_COLW_PREFIX + colId, op.width ?? undefined);
+            break;
+        }
     }
     const bd = data.blockdoc;
     return { data: { ...data, blockdoc: { ...bd, update: undefined, blocks } }, removedTable };