Ship this JSONL of local ops to your backend.

Path of the lock file (for diagnostics).

Iterate all ops in HLC order.

Default palette returned when nothing is configured. Mirrors the TUI's `theme::default_theme()` choice — `outl` is the brand palette every other clien

Fetch one block by id, or `null` if it no longer exists.

Path this store reads from / writes to (`<workspace>/.outl/peers.json` in prod). The transport keeps the path so its catch-up loop can reload peers a

Parse a `.md` string into a [`ParsedPage`].

Whether the log is empty.

Number of ops currently in the log.

Append a brand-new block as the last child of `parent` and return its id. `parent` defaults to [`NodeId::root`] when not supplied.

Tests don't need a real filesystem — `source_path` is just `root + journals/<slug>.md` / `pages/<slug>.md`. Using a constant root keeps assertions rea

Whether the tree currently contains a record for this node.

Length in characters.

Open the workspace at `path`. Returns a stable [`ApiError`] on any boot failure (missing workspace, bad config, filesystem error). Lock policy.** The

Read-only access to the materialized tree.

Whether the buffer is empty.

Build a deterministic `LogOp` at a chosen HLC.

Write a sidecar to disk as pretty-printed JSON. Uses [`crate::atomic::write_atomic`] so a crash mid-write can never leave a half-written sidecar that

Tokenize inline block content. Greedy left-to-right scan. Plain text accumulates between recognized constructs and emerges as a single [`InlineTok::P

Current parent of a node, or `None` if the node is not in the tree.

Produce the next monotonic HLC.

Convenience: a fractional position parsed from a literal.

Open the page for `slug`, creating it if it doesn't exist yet. The page's [`NodeId`] is derived deterministically from the slug (see [`page_id_from_s

Remove a peer by node_id prefix. Returns true if found.

Children of `parent` sorted ascending by their fractional position.

Read page metadata from a node. Returns `None` when the node is not a page (no `page-slug` property).

A fixed workspace id shared by both sides of a sync test. The serve side validates `SyncRequest.workspace_id` against the local id and rejects a mism

Convenience: `Create` under `parent` at `position`.

Build a fresh in-memory identity backed by a temp file path that doesn't exist yet (so `load_or_generate` generates + persists a new keypair).

Wire value used in the stored property.

Bind a sync-ALPN endpoint with the given identity, exactly like the transport's `run_iroh` does.

Block text content, if the block has any.

Emit a result either as JSON (when `as_json` is true) or by running the human formatter. On the JSON path, errors propagate via process exit code matc

Run `f` against the cached workspace, opening it on first use. The lock is held for the whole call — fine because the MCP stdio loop is single-thread

Extract a required string argument or return `INVALID_ARG`.

Convert a `#rrggbb` palette string into a ratatui [`Color`]. Malformed input degrades to [`Color::Reset`] instead of panicking so a bad config never

Read and validate a sidecar from disk. Accepts any version in `[MIN_READABLE_SIDECAR_VERSION, SIDECAR_VERSION]`. Older payloads are upgraded in-memor

Derive the canonical ref handle for a given block id. Format: `blk-` followed by the last [`REF_HANDLE_TAIL_LEN`] characters of the ULID's Crockford

Apply an op locally and persist it. The op is appended to the in-memory log, dispatched to the Yrs content store if it's an `Edit`, and persisted to

Write `count` real `Op::Create` ops authored by `actor` into `<workspace>/ops/ops-<actor>.jsonl` via the production `JsonlStorage`. Timestamps are an

Current position of a node, or `None` if the node is not in the tree.

Compute the canonical content hash of a block's text. The text is whitespace-normalized (internal whitespace collapsed to a single space, leading/tra

Compute the hash of the full `.md` file content.

Run a `outl tag …` invocation.

Render a `ParsedPage` to a `.md` string.

Compute the sidecar path for a given `.md` path. `pages/foo.md` → `pages/foo.outl`. The `.md` is dropped on purpose — the sidecar always pairs with a

Apply a new op to the log, reordering via undo/replay if necessary. Algorithm (per `docs/crdt.md` §`apply_op`): 1. If `new_op.ts` already in the log

Build a Yrs `update_v1` payload that, once wrapped in `Op::Edit { node, text_op }` and pushed through [`Self::apply`], rewrites the block's text to `n

Open the journal page for `date`, creating it if needed.

Render the page, write the `.md`, and (re)write its `.outl` sidecar to match the workspace tree exactly. This is the call clients use when they want

Mount the production `SyncProtocolHandler` on a `Router` and return it. Keep the returned `Router` alive for as long as the responder must accept con

Pop the most recent op. Used by `Tree::apply_op` while reordering.

Run the matching algorithm against new outline and old sidecar entries. Returns: - One [`Match`] per new block, in DFS preorder of the new AST. - Th

Render every block under `page_root` to a clean `.md` string, including** the page-level properties stored on the page node (`title::`, `icon::`, `pin

Most recent op (highest HLC), if any.

Reconcile a single `.md` file with the workspace. `orphan_log_path` receives one line per orphan id surfaced during matching. Pass `None` to suppress

Look up a page by slug. Returns the page root [`NodeId`] when found.

Return the path of indices to reach the block at `target_index` in DFS preorder. `None` if the index is out of range.

Run the production `delta_sync` initiator against `peer` (a full [`iroh::EndpointAddr`] from the responder's `endpoint.addr()`).

Drop both stacks. Call when the snapshots no longer describe the live workspace — e.g. on workspace switch, or after a peer merge **changed this page*

Load `config.toml` from the default path. Returns [`Config::default`] when the file doesn't exist (first launch), is empty, or fails to parse — all th

Show a short message (toast / status line, per client).

Extract an optional string argument.

Apply pasted markdown to the workspace at `anchor`. `raw` is the clipboard contents verbatim. The function: 1. Normalises external syntax to outl (s

Run an import against `vault`, returning the workspace TempDir (kept alive so the caller can read the produced files), the workspace [`Paths`], and th

One-shot page indexing — populates blocks, handles **and reverse refs in a single call. Safe to use after the initial build has finished: every cited

List every page in the workspace.

Current value of a property, or `None` if unset.

Render the in-memory `page` back to disk and reconcile. All writes go through [`outl_md::write_atomic`] so a crash between render and rename cannot l