@book.dev/sdk 1.60.0

package/dist/pageProperties.js

@@ -0,0 +1,97 @@
+/** Reserved, stable id for the Owner (person) property. */
+export const OWNER_PROPERTY_ID = 'sys_owner';
+/** Reserved, stable id for the Verification property. */
+export const VERIFICATION_PROPERTY_ID = 'sys_verification';
+/** Reserved, stable id for the Backlinks (computed) property. */
+export const BACKLINKS_PROPERTY_ID = 'sys_backlinks';
+/**
+ * Reserved ids for a page's **appearance**, stored on `page.properties` so a
+ * page's theme / cover / typefaces travel with the document (sync across
+ * devices) rather than living only in the local browser. They are appearance
+ * metadata — not panel/column properties — so they are intentionally NOT part
+ * of {@link SYSTEM_PAGE_PROPERTIES}.
+ */
+export const THEME_PROPERTY_ID = 'sys_theme';
+export const COVER_PROPERTY_ID = 'sys_cover';
+export const FONTS_PROPERTY_ID = 'sys_fonts';
+/** The page's emoji icon (a string). Projected into {@link PageMeta} so the
+ *  sidebar/tabs/mentions resolve it from the page list, not a per-page fetch. */
+export const ICON_PROPERTY_ID = 'sys_icon';
+/** The page's full-width layout flag (a boolean; absent = centered column). */
+export const FULLWIDTH_PROPERTY_ID = 'sys_fullwidth';
+/** The built-in properties every page carries, in panel order. */
+export const SYSTEM_PAGE_PROPERTIES = [
+    { id: OWNER_PROPERTY_ID, name: 'Owner', type: 'person' },
+    { id: VERIFICATION_PROPERTY_ID, name: 'Verification', type: 'verification' },
+    { id: BACKLINKS_PROPERTY_ID, name: 'Backlinks', type: 'backlinks' },
+];
+/** True when a stored value represents a verified page (ignoring expiry). */
+export function isVerified(value) {
+    return !!value && typeof value === 'object' && value.verified === true;
+}
+/** True when a verified page's verification has lapsed (expiry is in the past). */
+export function verificationExpired(value, nowMs = Date.now()) {
+    if (!isVerified(value))
+        return false;
+    const exp = value.expiresAt;
+    return !!exp && new Date(exp).getTime() <= nowMs;
+}
+/** True when a page is verified AND its verification has not lapsed. */
+export function isVerificationActive(value, nowMs = Date.now()) {
+    return isVerified(value) && !verificationExpired(value, nowMs);
+}
+/**
+ * A verification value stamped as verified now (the caller supplies the time).
+ * `expiresAtIso` sets an expiry; omit/`null` for a verification that never
+ * lapses.
+ */
+export function makeVerification(by, atIso, expiresAtIso) {
+    return {
+        verified: true,
+        by: by && by.trim() ? by.trim() : null,
+        at: atIso,
+        ...(expiresAtIso ? { expiresAt: expiresAtIso } : {}),
+    };
+}
+/**
+ * Pure: the set of page ids this snapshot links to, by scanning the EditorJS
+ * blocks for inline mention anchors (`<a … data-page-id="…">`). Order-preserving
+ * and de-duplicated — the out-edges of one page in the backlink graph.
+ *
+ * Works on both the raw HTML form (`data-page-id="id"`) and the JSON-escaped
+ * form (`data-page-id=\"id\"`) that appears once the document is serialised, so
+ * it can run over a parsed snapshot or a stringified one alike.
+ */
+/**
+ * Pure: does a page's stored `properties` reference `id`? True when any property
+ * value equals `id`, or `id` is an element of an array-valued property (a
+ * `relation`). This lets the backlink graph count relation links — set on a
+ * row's properties — alongside inline `@`-mentions in the document.
+ */
+export function propertiesReferencePage(properties, id) {
+    if (!properties)
+        return false;
+    for (const value of Object.values(properties)) {
+        if (value === id)
+            return true;
+        if (Array.isArray(value) && value.includes(id))
+            return true;
+    }
+    return false;
+}
+export function extractMentionIds(snapshot) {
+    const json = JSON.stringify(snapshot.editorjs ?? {});
+    const ids = [];
+    const seen = new Set();
+    const re = /data-page-id=\\?["']([^"'\\]+)/g;
+    let match;
+    while ((match = re.exec(json)) !== null) {
+        const id = match[1];
+        if (!seen.has(id)) {
+            seen.add(id);
+            ids.push(id);
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=pageProperties.js.map

package/dist/pageProperties.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The plugin contract: what a plugin package IS (a manifest + TypeScript
+ * source files), and the signing scheme that lets a registry vouch for one.
+ *
+ * Trust model, stated plainly: plugins run with the same privileges as the
+ * document's own live code — signing provides **provenance** (this exact
+ * content was published by a registry you trust), not sandboxing. Unsigned
+ * plugins install fine and are labelled unverified.
+ *
+ * Signing: Ed25519 over a canonical SHA-256 digest of the manifest + every
+ * file (sorted paths, length-prefixed — byte-stable across platforms). The
+ * app pins the first-party OpenBook registry key; users can trust additional
+ * registry keys, which is all a "third-party registry" needs to be.
+ */
+/**
+ * An agent tool a plugin contributes. Declared in the manifest (so the server
+ * can read it from the stored manifest JSON and surface it to the agent without
+ * running any plugin code). The tool's `action` maps to a built-in write
+ * primitive that the confirm-gate then applies — so a plugin tool can propose
+ * workspace changes, but it cannot execute arbitrary server code. Signing
+ * provides provenance, NOT sandboxing — see the module trust note.
+ */
+export interface PluginAgentTool {
+    /** Tool name the agent calls (namespaced to avoid clashing with built-ins). */
+    name: string;
+    /** What the tool does (shown to the model). */
+    description: string;
+    /** JSON-Schema for the tool's arguments object. */
+    parameters?: Record<string, unknown>;
+    /**
+     * The built-in primitive this tool drives. `append_blocks` proposes adding
+     * the given blocks to a page; `prompt` simply inlines `instructions` into the
+     * agent's context (a recipe). Kept deliberately small — no code execution.
+     */
+    action: 'append_blocks' | 'prompt';
+    /** For `action: 'prompt'`: the instructions inlined when the tool is invoked. */
+    instructions?: string;
+}
+export interface PluginManifest {
+    /** Stable reverse-DNS-ish identifier, e.g. `openbook.hello-world`. */
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    /** Emoji shown in lists (keeps the gallery dependency-free). */
+    icon?: string;
+    /** Entry file inside the package, e.g. `src/index.ts`. */
+    main: string;
+    /** Agent tools this plugin contributes (read server-side from the manifest). */
+    agentTools?: PluginAgentTool[];
+}
+/** A plugin as stored/transported: manifest + its TypeScript source files. */
+export interface PluginPackage {
+    manifest: PluginManifest;
+    /** path → source text (TypeScript or JavaScript). */
+    files: Record<string, string>;
+    signature?: PluginSignature;
+}
+export interface PluginSignature {
+    /** Human-readable registry name shown in the UI, e.g. `OpenBook Registry`. */
+    registry: string;
+    /** base64 raw Ed25519 public key of the signing registry. */
+    publicKey: string;
+    /** base64 Ed25519 signature over {@link canonicalDigest}. */
+    signature: string;
+    algorithm: 'ed25519';
+}
+/** An installed plugin row as the server stores/lists it. */
+export interface StoredPlugin extends PluginPackage {
+    enabled: boolean;
+    installedAt: string;
+    /** Set by the client after verification — never trusted from the wire. */
+    verified?: boolean;
+}
+/** SHA-256 of the canonical bytes (hex) — the thing a registry signs. */
+export declare function canonicalDigest(manifest: PluginManifest, files: Record<string, string>): Promise<string>;
+/** Generate a registry keypair (raw public / pkcs8 private, base64). */
+export declare function generateRegistryKeys(): Promise<{
+    publicKey: string;
+    privateKey: string;
+}>;
+/** Sign a package (registry-side tooling — needs the private key). */
+export declare function signPlugin(pkg: {
+    manifest: PluginManifest;
+    files: Record<string, string>;
+}, privateKeyBase64: string, registry: string, publicKeyBase64: string): Promise<PluginSignature>;
+/**
+ * Verify a package against a set of trusted registry keys. Returns the
+ * matching trusted registry name, or null when unsigned, signed by an
+ * untrusted key, or tampered with.
+ */
+export declare function verifyPlugin(pkg: PluginPackage, trustedKeys: Array<{
+    name: string;
+    publicKey: string;
+}>): Promise<{
+    registry: string;
+} | null>;
+/**
+ * The pinned first-party registry key. Every OpenBook build trusts this;
+ * additional registries are user-added keys on top (Settings → Extensions).
+ * NOTE: a placeholder development key until the real registry launches —
+ * regenerate and replace before publishing plugins for real.
+ */
+export declare const OPENBOOK_REGISTRY: {
+    name: string;
+    publicKey: string;
+};
+/** Validate a manifest's shape; returns a human-readable problem or null. */
+export declare function validateManifest(m: unknown): string | null;

package/dist/plugins.js

@@ -0,0 +1,113 @@
+/**
+ * The plugin contract: what a plugin package IS (a manifest + TypeScript
+ * source files), and the signing scheme that lets a registry vouch for one.
+ *
+ * Trust model, stated plainly: plugins run with the same privileges as the
+ * document's own live code — signing provides **provenance** (this exact
+ * content was published by a registry you trust), not sandboxing. Unsigned
+ * plugins install fine and are labelled unverified.
+ *
+ * Signing: Ed25519 over a canonical SHA-256 digest of the manifest + every
+ * file (sorted paths, length-prefixed — byte-stable across platforms). The
+ * app pins the first-party OpenBook registry key; users can trust additional
+ * registry keys, which is all a "third-party registry" needs to be.
+ */
+const te = new TextEncoder();
+/**
+ * Deterministic bytes for signing: the manifest (sorted-key JSON), then each
+ * file in sorted path order, every part length-prefixed so boundaries can't
+ * be confused (`a + bc` ≠ `ab + c`).
+ */
+function canonicalBytes(manifest, files) {
+    const parts = [];
+    const push = (s) => {
+        const bytes = te.encode(s);
+        const len = new Uint8Array(4);
+        new DataView(len.buffer).setUint32(0, bytes.length);
+        parts.push(len, bytes);
+    };
+    push(JSON.stringify(manifest, Object.keys(manifest).sort()));
+    for (const path of Object.keys(files).sort()) {
+        push(path);
+        push(files[path]);
+    }
+    const total = parts.reduce((n, p) => n + p.length, 0);
+    const out = new Uint8Array(total);
+    let at = 0;
+    for (const p of parts) {
+        out.set(p, at);
+        at += p.length;
+    }
+    return out;
+}
+/** SHA-256 of the canonical bytes (hex) — the thing a registry signs. */
+export async function canonicalDigest(manifest, files) {
+    const hash = await crypto.subtle.digest('SHA-256', canonicalBytes(manifest, files));
+    return [...new Uint8Array(hash)].map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+const fromBase64 = (s) => Uint8Array.from(atob(s), (c) => c.charCodeAt(0));
+const toBase64 = (b) => btoa(String.fromCharCode(...b));
+/** Generate a registry keypair (raw public / pkcs8 private, base64). */
+export async function generateRegistryKeys() {
+    const pair = (await crypto.subtle.generateKey('Ed25519', true, ['sign', 'verify']));
+    const pub = new Uint8Array(await crypto.subtle.exportKey('raw', pair.publicKey));
+    const priv = new Uint8Array(await crypto.subtle.exportKey('pkcs8', pair.privateKey));
+    return { publicKey: toBase64(pub), privateKey: toBase64(priv) };
+}
+/** Sign a package (registry-side tooling — needs the private key). */
+export async function signPlugin(pkg, privateKeyBase64, registry, publicKeyBase64) {
+    const key = await crypto.subtle.importKey('pkcs8', fromBase64(privateKeyBase64), 'Ed25519', false, ['sign']);
+    const digest = await canonicalDigest(pkg.manifest, pkg.files);
+    const sig = new Uint8Array(await crypto.subtle.sign('Ed25519', key, te.encode(digest)));
+    return { registry, publicKey: publicKeyBase64, signature: toBase64(sig), algorithm: 'ed25519' };
+}
+/**
+ * Verify a package against a set of trusted registry keys. Returns the
+ * matching trusted registry name, or null when unsigned, signed by an
+ * untrusted key, or tampered with.
+ */
+export async function verifyPlugin(pkg, trustedKeys) {
+    const sig = pkg.signature;
+    if (!sig || sig.algorithm !== 'ed25519')
+        return null;
+    const trusted = trustedKeys.find((k) => k.publicKey === sig.publicKey);
+    if (!trusted)
+        return null;
+    try {
+        const key = await crypto.subtle.importKey('raw', fromBase64(sig.publicKey), 'Ed25519', false, ['verify']);
+        const digest = await canonicalDigest(pkg.manifest, pkg.files);
+        const ok = await crypto.subtle.verify('Ed25519', key, fromBase64(sig.signature), te.encode(digest));
+        return ok ? { registry: trusted.name } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The pinned first-party registry key. Every OpenBook build trusts this;
+ * additional registries are user-added keys on top (Settings → Extensions).
+ * NOTE: a placeholder development key until the real registry launches —
+ * regenerate and replace before publishing plugins for real.
+ */
+export const OPENBOOK_REGISTRY = {
+    name: 'OpenBook Registry',
+    publicKey: 'nI4eBQzqrIyVPEmJSEzGtqC9B0+kfWTXKyN5t8Yki/E=',
+};
+const PLUGIN_ID_RE = /^[a-z0-9][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*)+$/;
+/** Validate a manifest's shape; returns a human-readable problem or null. */
+export function validateManifest(m) {
+    if (!m || typeof m !== 'object')
+        return 'openbook.json is missing or not an object';
+    const man = m;
+    if (!man.id || typeof man.id !== 'string' || !PLUGIN_ID_RE.test(man.id)) {
+        return 'id must look like "publisher.plugin-name" (lowercase, dots and dashes)';
+    }
+    if (!man.name || typeof man.name !== 'string')
+        return 'name is required';
+    if (!man.version || typeof man.version !== 'string')
+        return 'version is required';
+    if (!man.main || typeof man.main !== 'string')
+        return 'main (the entry file) is required';
+    return null;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoEH,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;AAE7B;;;;GAIG;AACH,SAAS,cAAc,CAAC,QAAwB,EAAE,KAA6B;IAC7E,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAQ,EAAE;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;QACX,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAwB,EAAE,KAA6B;IAC3F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAiB,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS,EAAc,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,MAAM,QAAQ,GAAG,CAAC,CAAa,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE5E,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAkB,CAAC;IACrG,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACjF,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACrF,OAAO,EAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAC,CAAC;AAChE,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAA8D,EAC9D,gBAAwB,EACxB,QAAgB,EAChB,eAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,gBAAgB,CAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7H,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAiB,CAAC,CAAC,CAAC;IACxG,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,SAAS,EAAC,CAAC;AAChG,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAkB,EAClB,WAAqD;IAErD,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC;IAC1B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1H,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAiB,CAAC,CAAC;QACpI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,8CAA8C;CAC1D,CAAC;AAEF,MAAM,YAAY,GAAG,6CAA6C,CAAC;AAEnE,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,2CAA2C,CAAC;IACpF,MAAM,GAAG,GAAG,CAA4B,CAAC;IACzC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACxE,OAAO,wEAAwE,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,kBAAkB,CAAC;IACzE,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,qBAAqB,CAAC;IAClF,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,mCAAmC,CAAC;IAC1F,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The HTTP contract shared by the server and clients. Keeping the paths in one
+ * place means `HttpDataClient` and the server's router cannot disagree about
+ * where a resource lives.
+ */
+export declare const API: {
+    readonly health: "/health";
+    /** Collection: `GET` (list) / `POST` (create). */
+    readonly pages: "/api/pages";
+    /** Single page: `GET` / `PUT` (upsert) / `PATCH` (rename) / `DELETE` (to trash). */
+    readonly page: (id: string) => string;
+    /** A page's structured properties (owner, verification, …): `PATCH` (shallow merge). */
+    readonly pageProperties: (id: string) => string;
+    /** Pages that link to this one (the backlink graph): `GET`. */
+    readonly pageBacklinks: (id: string) => string;
+    /** Restore a trashed page (and the subtree trashed with it): `POST`. */
+    readonly pageRestore: (id: string) => string;
+    /** Move/reorder a page in the sidebar tree (re-parent + reorder siblings): `PUT`. */
+    readonly pageMove: (id: string) => string;
+    /** Whole-space backup: `GET` returns every live page + database as one bundle. */
+    readonly exportSpace: "/api/export";
+    /** Restore a backup: `POST` `{pages, databases, mode}` → import summary. */
+    readonly importSpace: "/api/import";
+    /** The trash: `GET` (list trashed pages) / `DELETE` (empty the whole trash). */
+    readonly trash: "/api/trash";
+    /** A single trashed page: `DELETE` (permanently purge it and its subtree). */
+    readonly trashItem: (id: string) => string;
+    /** SSE stream of the page list (created / renamed / deleted). */
+    readonly stream: "/api/stream";
+    /** SSE stream of a single page's live updates + deletion. */
+    readonly pageStream: (id: string) => string;
+    /**
+     * The multiplexed live stream: one SSE connection carrying every event (page
+     * list, page updates/deletions, database rows). Clients open exactly one of
+     * these per tab and filter by the ids they care about, so an open tab costs a
+     * single connection regardless of how many pages/databases it watches.
+     */
+    readonly live: "/api/live";
+    /** Collection: `POST` (create a database for a host page). */
+    readonly databases: "/api/databases";
+    /** Single database: `GET` / `PATCH` (name + schema) / `DELETE`. */
+    readonly database: (id: string) => string;
+    /** The database hosted by a page: `GET` (or 404 if the page hosts none). */
+    readonly pageDatabase: (pageId: string) => string;
+    /** A database's rows: `GET` (list) / `POST` (create a row page). */
+    readonly databaseRows: (id: string) => string;
+    /** Set the manual row order: `PUT` `{orderedIds}`. */
+    readonly databaseRowsOrder: (id: string) => string;
+    /** A single row: `PATCH` (title + manual properties). Row content/deletion use the page routes. */
+    readonly databaseRow: (id: string, rowId: string) => string;
+    /** SSE stream of a database's row list (any row created / edited / deleted). */
+    readonly databaseStream: (id: string) => string;
+    /** Engine status (provider, readiness, index state, download progress): `GET`. */
+    readonly aiStatus: "/api/ai/status";
+    /** Engine configuration: `PUT` `{provider, model?, baseUrl?, autoStart?}`. */
+    readonly aiConfig: "/api/ai/config";
+    /** (Re)build the note-search index: `POST`. */
+    readonly aiIndex: "/api/ai/index";
+    /** Search notes: `POST` `{query, limit?}` → ranked results + snippets. */
+    readonly aiSearch: "/api/ai/search";
+    /** Stream a completion: `POST` `{prompt, system?, maxTokens?}` → SSE. */
+    readonly aiGenerate: "/api/ai/generate";
+    /** Break a goal into actionable tasks: `POST` `{goal, context?}`. */
+    readonly aiTasks: "/api/ai/tasks";
+    /** Continue/complete document text: `POST` `{text, instruction?}` → SSE. */
+    readonly aiComplete: "/api/ai/complete";
+    /** Download a model file for the in-process engine: `POST` `{url?}`. */
+    readonly aiModelDownload: "/api/ai/models/download";
+    /** The agent harness: `POST` `{messages, effort?, thinking?, skills?}` → SSE tool/reasoning/proposal/final events. */
+    readonly agentChat: "/api/agent/chat";
+    /** User-authored prompt/recipe skills: `GET` (list) / `PUT` `{skill}` (upsert). */
+    readonly aiSkills: "/api/ai/skills";
+    /** One skill by name: `DELETE`. */
+    readonly aiSkill: (name: string) => string;
+    readonly plugins: "/api/plugins";
+    readonly plugin: (id: string) => string;
+    /** A page's suggestions: `GET` (list, optionally `?status=open`) / `POST` (create). */
+    readonly suggestions: (pageId: string) => string;
+    /** A single suggestion: `PATCH` (status: accepted/rejected) / `DELETE`. */
+    readonly suggestion: (id: string) => string;
+    /** A page's comments (standalone block comments + suggestion threads): `GET` / `POST` (create). */
+    readonly comments: (pageId: string) => string;
+    /** A single comment: `DELETE`. */
+    readonly comment: (id: string) => string;
+};
+/** Error body shape returned by the API for non-2xx responses. */
+export interface ApiError {
+    error: string;
+}

package/dist/routes.js

@@ -0,0 +1,89 @@
+/**
+ * The HTTP contract shared by the server and clients. Keeping the paths in one
+ * place means `HttpDataClient` and the server's router cannot disagree about
+ * where a resource lives.
+ */
+export const API = {
+    health: '/health',
+    /** Collection: `GET` (list) / `POST` (create). */
+    pages: '/api/pages',
+    /** Single page: `GET` / `PUT` (upsert) / `PATCH` (rename) / `DELETE` (to trash). */
+    page: (id) => `/api/pages/${encodeURIComponent(id)}`,
+    /** A page's structured properties (owner, verification, …): `PATCH` (shallow merge). */
+    pageProperties: (id) => `/api/pages/${encodeURIComponent(id)}/properties`,
+    /** Pages that link to this one (the backlink graph): `GET`. */
+    pageBacklinks: (id) => `/api/pages/${encodeURIComponent(id)}/backlinks`,
+    /** Restore a trashed page (and the subtree trashed with it): `POST`. */
+    pageRestore: (id) => `/api/pages/${encodeURIComponent(id)}/restore`,
+    /** Move/reorder a page in the sidebar tree (re-parent + reorder siblings): `PUT`. */
+    pageMove: (id) => `/api/pages/${encodeURIComponent(id)}/move`,
+    /** Whole-space backup: `GET` returns every live page + database as one bundle. */
+    exportSpace: '/api/export',
+    /** Restore a backup: `POST` `{pages, databases, mode}` → import summary. */
+    importSpace: '/api/import',
+    /** The trash: `GET` (list trashed pages) / `DELETE` (empty the whole trash). */
+    trash: '/api/trash',
+    /** A single trashed page: `DELETE` (permanently purge it and its subtree). */
+    trashItem: (id) => `/api/trash/${encodeURIComponent(id)}`,
+    /** SSE stream of the page list (created / renamed / deleted). */
+    stream: '/api/stream',
+    /** SSE stream of a single page's live updates + deletion. */
+    pageStream: (id) => `/api/pages/${encodeURIComponent(id)}/stream`,
+    /**
+     * The multiplexed live stream: one SSE connection carrying every event (page
+     * list, page updates/deletions, database rows). Clients open exactly one of
+     * these per tab and filter by the ids they care about, so an open tab costs a
+     * single connection regardless of how many pages/databases it watches.
+     */
+    live: '/api/live',
+    // ── Databases ──────────────────────────────────────────────────────────────
+    /** Collection: `POST` (create a database for a host page). */
+    databases: '/api/databases',
+    /** Single database: `GET` / `PATCH` (name + schema) / `DELETE`. */
+    database: (id) => `/api/databases/${encodeURIComponent(id)}`,
+    /** The database hosted by a page: `GET` (or 404 if the page hosts none). */
+    pageDatabase: (pageId) => `/api/pages/${encodeURIComponent(pageId)}/database`,
+    /** A database's rows: `GET` (list) / `POST` (create a row page). */
+    databaseRows: (id) => `/api/databases/${encodeURIComponent(id)}/rows`,
+    /** Set the manual row order: `PUT` `{orderedIds}`. */
+    databaseRowsOrder: (id) => `/api/databases/${encodeURIComponent(id)}/rows/order`,
+    /** A single row: `PATCH` (title + manual properties). Row content/deletion use the page routes. */
+    databaseRow: (id, rowId) => `/api/databases/${encodeURIComponent(id)}/rows/${encodeURIComponent(rowId)}`,
+    /** SSE stream of a database's row list (any row created / edited / deleted). */
+    databaseStream: (id) => `/api/databases/${encodeURIComponent(id)}/stream`,
+    // ── Optional local AI ──────────────────────────────────────────────────────
+    /** Engine status (provider, readiness, index state, download progress): `GET`. */
+    aiStatus: '/api/ai/status',
+    /** Engine configuration: `PUT` `{provider, model?, baseUrl?, autoStart?}`. */
+    aiConfig: '/api/ai/config',
+    /** (Re)build the note-search index: `POST`. */
+    aiIndex: '/api/ai/index',
+    /** Search notes: `POST` `{query, limit?}` → ranked results + snippets. */
+    aiSearch: '/api/ai/search',
+    /** Stream a completion: `POST` `{prompt, system?, maxTokens?}` → SSE. */
+    aiGenerate: '/api/ai/generate',
+    /** Break a goal into actionable tasks: `POST` `{goal, context?}`. */
+    aiTasks: '/api/ai/tasks',
+    /** Continue/complete document text: `POST` `{text, instruction?}` → SSE. */
+    aiComplete: '/api/ai/complete',
+    /** Download a model file for the in-process engine: `POST` `{url?}`. */
+    aiModelDownload: '/api/ai/models/download',
+    /** The agent harness: `POST` `{messages, effort?, thinking?, skills?}` → SSE tool/reasoning/proposal/final events. */
+    agentChat: '/api/agent/chat',
+    /** User-authored prompt/recipe skills: `GET` (list) / `PUT` `{skill}` (upsert). */
+    aiSkills: '/api/ai/skills',
+    /** One skill by name: `DELETE`. */
+    aiSkill: (name) => `/api/ai/skills/${encodeURIComponent(name)}`,
+    plugins: '/api/plugins',
+    plugin: (id) => `/api/plugins/${id}`,
+    // ── Suggestions + comments (the review layer) ────────────────────────────────
+    /** A page's suggestions: `GET` (list, optionally `?status=open`) / `POST` (create). */
+    suggestions: (pageId) => `/api/pages/${encodeURIComponent(pageId)}/suggestions`,
+    /** A single suggestion: `PATCH` (status: accepted/rejected) / `DELETE`. */
+    suggestion: (id) => `/api/suggestions/${encodeURIComponent(id)}`,
+    /** A page's comments (standalone block comments + suggestion threads): `GET` / `POST` (create). */
+    comments: (pageId) => `/api/pages/${encodeURIComponent(pageId)}/comments`,
+    /** A single comment: `DELETE`. */
+    comment: (id) => `/api/comments/${encodeURIComponent(id)}`,
+};
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/sampleDocument.d.ts

@@ -0,0 +1,25 @@
+import type { DataClient } from './client';
+import type { PageInput, StoredPage } from './types';
+/**
+ * A known-good document that exercises the reactive blocks end to end, plus a
+ * one-call seeder for it. A `months` slider feeds a live code block that emits
+ * four compound-growth curves, which a kit chart plots. Used by the `seed` CLI
+ * command and the in-app "Insert sample document" action so testing and
+ * dogfooding never need a document rebuilt by hand.
+ *
+ * Authored as a **block-doc** (`editor: 'blocks'` + a `blockdoc.blocks` JSON
+ * projection), the same native shape the gallery templates use — NOT the legacy
+ * EditorJS form. (The old EditorJS version migrated its `chart` block into a
+ * "not supported" warning callout, since the migration has no chart target; the
+ * native `kitchart` block renders the curves directly.)
+ */
+/** Name of the seeded page. Unique (page names are), so re-seeding is idempotent. */
+export declare const SAMPLE_DOCUMENT_NAME = "Compound Growth (sample)";
+/** Build the sample document as a {@link PageInput} (no id → a fresh page). */
+export declare function buildSampleDocument(): PageInput;
+/**
+ * Upsert the sample document through a data client and return the stored page.
+ * Idempotent: reuses the existing sample page's id (names are unique) so
+ * re-seeding refreshes it in place instead of 409-ing on the name conflict.
+ */
+export declare function seedSampleDocument(client: DataClient): Promise<StoredPage>;

package/dist/sampleDocument.js

@@ -0,0 +1,67 @@
+/**
+ * A known-good document that exercises the reactive blocks end to end, plus a
+ * one-call seeder for it. A `months` slider feeds a live code block that emits
+ * four compound-growth curves, which a kit chart plots. Used by the `seed` CLI
+ * command and the in-app "Insert sample document" action so testing and
+ * dogfooding never need a document rebuilt by hand.
+ *
+ * Authored as a **block-doc** (`editor: 'blocks'` + a `blockdoc.blocks` JSON
+ * projection), the same native shape the gallery templates use — NOT the legacy
+ * EditorJS form. (The old EditorJS version migrated its `chart` block into a
+ * "not supported" warning callout, since the migration has no chart target; the
+ * native `kitchart` block renders the curves directly.)
+ */
+/** Name of the seeded page. Unique (page names are), so re-seeding is idempotent. */
+export const SAMPLE_DOCUMENT_NAME = 'Compound Growth (sample)';
+const INITIAL_MONTHS = 120;
+// `months` is published by the slider; this live block reads it and returns an
+// object of named arrays — the multi-series shape the kit chart plots (one line
+// per annual rate). Returning bare arrays here would collapse to a single line.
+const GROWTH_SOURCE = `return {
+  '3%':  Array.from({length: months}, (_, i) => Math.pow(1.03, i / 12)),
+  '5%':  Array.from({length: months}, (_, i) => Math.pow(1.05, i / 12)),
+  '7%':  Array.from({length: months}, (_, i) => Math.pow(1.07, i / 12)),
+  '10%': Array.from({length: months}, (_, i) => Math.pow(1.10, i / 12)),
+};`;
+/** The reactive sample as a block-doc projection (ids double as stable block ids). */
+const SAMPLE_BLOCKS = [
+    {
+        id: 'sample-intro',
+        type: 'paragraph',
+        text: [
+            { t: 'Sample reactive document. Drag ' },
+            { t: 'months', a: { b: true } },
+            { t: ' to watch four compound-growth curves (3 / 5 / 7 / 10% annual) recompute live.' },
+        ],
+    },
+    { id: 'sample-months', type: 'slider', props: { name: 'months', label: 'Months', value: INITIAL_MONTHS, min: 1, max: 360 } },
+    {
+        id: 'sample-growth',
+        type: 'code',
+        text: [{ t: GROWTH_SOURCE }],
+        props: { live: true, name: 'growth', language: 'js', collapsed: true },
+    },
+    { id: 'sample-chart', type: 'kitchart', props: { kind: 'line', title: 'Growth of £1 by annual rate', source: 'growth' } },
+];
+/** Build the sample document as a {@link PageInput} (no id → a fresh page). */
+export function buildSampleDocument() {
+    const data = {
+        editorjs: { blocks: [] },
+        values: [],
+        names: [],
+        editor: 'blocks',
+        blockdoc: { blocks: SAMPLE_BLOCKS },
+    };
+    return { name: SAMPLE_DOCUMENT_NAME, data };
+}
+/**
+ * Upsert the sample document through a data client and return the stored page.
+ * Idempotent: reuses the existing sample page's id (names are unique) so
+ * re-seeding refreshes it in place instead of 409-ing on the name conflict.
+ */
+export async function seedSampleDocument(client) {
+    const existing = (await client.listPages()).find((p) => p.name === SAMPLE_DOCUMENT_NAME);
+    const input = buildSampleDocument();
+    return client.savePage(existing ? { ...input, id: existing.id } : input);
+}
+//# sourceMappingURL=sampleDocument.js.map

package/dist/sampleDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampleDocument.js","sourceRoot":"","sources":["../src/sampleDocument.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAE/D,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,MAAM,aAAa,GAAG;;;;;GAKnB,CAAC;AAEJ,sFAAsF;AACtF,MAAM,aAAa,GAAG;IACpB;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE;YACJ,EAAC,CAAC,EAAE,iCAAiC,EAAC;YACtC,EAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAC,CAAC,EAAE,IAAI,EAAC,EAAC;YAC3B,EAAC,CAAC,EAAE,gFAAgF,EAAC;SACtF;KACF;IACD,EAAC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAC,EAAC;IACxH;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,CAAC,EAAC,CAAC,EAAE,aAAa,EAAC,CAAC;QAC1B,KAAK,EAAE,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAC;KACrE;IACD,EAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,6BAA6B,EAAE,MAAM,EAAE,QAAQ,EAAC,EAAC;CACtH,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAiB;QACzB,QAAQ,EAAE,EAAC,MAAM,EAAE,EAAE,EAAC;QACtB,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC;KAClC,CAAC;IACF,OAAO,EAAC,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAkB;IACzD,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAC,GAAG,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}