@roam-research/roam-tools-core 0.5.0 → 0.6.0

package/README.md

@@ -1,17 +1,32 @@
 # @roam-research/roam-tools-core
 
-Shared core library for Roam Research tools. Provides the Roam API client, tool definitions, graph resolution, and operations.
+Transport-agnostic core for Roam Research MCP and CLI tools. Provides the tool registry, schemas, operation functions, and dispatch — but no transport.
 
-> **This package is not meant to be used directly.** It is an internal dependency of [`@roam-research/roam-mcp`](https://www.npmjs.com/package/@roam-research/roam-mcp) (MCP server) and [`@roam-research/roam-cli`](https://www.npmjs.com/package/@roam-research/roam-cli) (CLI). If you want to connect an AI assistant to Roam, install `@roam-research/roam-mcp`. If you want a command-line interface, install `@roam-research/roam-cli`.
+> **Most users don't want this package directly.** If you want to connect an AI assistant to Roam, install [`@roam-research/roam-mcp`](https://www.npmjs.com/package/@roam-research/roam-mcp). For the command line, install [`@roam-research/roam-cli`](https://www.npmjs.com/package/@roam-research/roam-cli). Both wrap the local Roam Desktop transport ([`@roam-research/roam-tools-local`](https://www.npmjs.com/package/@roam-research/roam-tools-local)) which depends on this package.
+
+## Who is this for?
+
+This package is for **hosted MCP transports** that talk to Roam through a different backend (e.g., a WorkOS-authenticated proxy) and want to reuse the same tool registry, Zod schemas, and operation functions without dragging in the local Roam Desktop client or the `~/.roam-tools.json` config reader.
 
 ## What's in here
 
-- **RoamClient** — authenticated HTTP client for Roam's local API
-- **Tool definitions** — Zod-validated tool schemas used by both MCP and CLI
-- **Operations** — page, block, search, query, file, and navigation operations
-- **Graph resolution** — config loading, graph lookup, and multi-graph support
-- **Types** — shared TypeScript types, error codes, and schemas
+- `RoamActionClient` — structural client interface (`call()` + optional `getTokenInfo()`). Bring your own implementation.
+- `routeToolCall(name, args, options)` — central dispatcher. **Requires** `options.resolveGraph` and `options.createClient`. Optional: `tokenInfoMode`, `onTokenStatusUpdate`.
+- `ToolGraph` / `ResolvedGraph` — cross-transport graph identity types.
+- Tool registry: `dataTools` (graph content, reusable across transports), `desktopUiTools` (file ops + window/selection — local-only), `contentTools` (the union), `tools` (alias of contentTools at this layer).
+- Helpers: `defineTool`, `defineStandaloneTool`, `findTool`.
+- Operations: page, block, search, query, datalog, navigation, files (all transport-agnostic — they only call `client.call(...)`).
+- Types and schemas: `GraphConfigSchema`, `RoamMcpConfigSchema`, `RoamError`, `ErrorCodes`, `EXPECTED_API_VERSION`, etc.
+
+## What's NOT in here
+
+- `RoamClient` — the local Roam Desktop transport, in `@roam-research/roam-tools-local`.
+- `~/.roam-tools.json` reader (`getPort`, `resolveGraph`, `getMcpConfig`, etc.) — also in `@roam-research/roam-tools-local`.
+- `connect` interactive setup — also in `@roam-research/roam-tools-local`.
+- The `list_graphs` and `setup_new_graph` standalone tools — also local.
+
+Hosted consumers reimplement these (or substitute their own equivalents — e.g., reading picker grants from a remote store) and inject them via `routeToolCall`'s options.
 
 ## Documentation
 
-See the [main repository](https://github.com/Roam-Research/roam-tools) for full documentation.
+See the [main repository](https://github.com/Roam-Research/roam-tools) for full documentation, including the architecture rationale and the integration pattern.

package/dist/index.d.ts

@@ -1,9 +1,5 @@
-export type { CallToolResult, TextContent, ImageContent, GraphType, AccessLevel, GraphConfig, RoamMcpConfig, ResolvedGraph, ErrorCode, RoamApiError, RoamResponse, RoamClientConfig, Block, Page, BlockLocation, WindowType, SidebarWindow, SidebarWindowInfo, FocusedBlock, SelectedBlock, MainWindowViewType, MainWindowView, SearchResultPath, SearchResult, SearchResponse, RecentlyOpenedBlock, RecentlyOpenedItem, DailyNotePagesViewItem, RecentlyEditedPage, SearchSuggestionsResponse, SearchTemplatesResponse, GetPageResponse, GetBlockResponse, Template, QueryResult, QueryResponse, TokenInfoResponse, TokenInfoResult, } from "./types.js";
+export type { CallToolResult, TextContent, ImageContent, GraphType, AccessLevel, GraphConfig, RoamMcpConfig, ToolGraph, ResolvedGraph, RoamActionClient, ErrorCode, RoamApiError, RoamResponse, Block, Page, BlockLocation, WindowType, SidebarWindow, SidebarWindowInfo, FocusedBlock, SelectedBlock, MainWindowViewType, MainWindowView, SearchResultPath, SearchResult, SearchResponse, RecentlyOpenedBlock, RecentlyOpenedItem, DailyNotePagesViewItem, RecentlyEditedPage, SearchSuggestionsResponse, SearchTemplatesResponse, GetPageResponse, GetBlockResponse, Template, QueryResult, QueryResponse, TokenInfoResponse, TokenInfoResult, } from "./types.js";
 export { GraphConfigSchema, RoamMcpConfigSchema, ErrorCodes, RoamError, CONFIG_VERSION, EXPECTED_API_VERSION, textResult, imageResult, errorResult, getErrorMessage, } from "./types.js";
-export { RoamClient } from "./client.js";
-export { getPort, resolveGraph, saveGraphToConfig, removeGraphFromConfig, updateGraphTokenStatus, getConfiguredGraphsSafe, getConfiguredGraphs, findGraphConfig, getMcpConfig, getOpenGraphs, } from "./graph-resolver.js";
-export { fetchAvailableGraphs, requestToken, sleep, openRoamApp, slugify, } from "./roam-api.js";
-export type { AvailableGraph, GraphsResponse, TokenExchangeResponse, } from "./roam-api.js";
-export { tools, findTool, routeToolCall } from "./tools.js";
-export type { ToolDefinition, ClientToolDefinition, StandaloneToolDefinition, } from "./tools.js";
+export { tools, findTool, routeToolCall, contentTools, dataTools, desktopUiTools, defineTool, defineStandaloneTool, } from "./tools.js";
+export type { ToolDefinition, ClientToolDefinition, StandaloneToolDefinition, RouteToolCallOptions, } from "./tools.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,cAAc,EAAE,WAAW,EAAE,YAAY,EACzC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EACjE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EACvD,KAAK,EAAE,IAAI,EAAE,aAAa,EAC1B,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAC5C,YAAY,EAAE,aAAa,EAC3B,kBAAkB,EAAE,cAAc,EAClC,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAC9C,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,EACnF,yBAAyB,EAAE,uBAAuB,EAClD,eAAe,EAAE,gBAAgB,EACjC,QAAQ,EAAE,WAAW,EAAE,aAAa,EACpC,iBAAiB,EAAE,eAAe,GACnC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EACtC,UAAU,EAAE,SAAS,EACrB,cAAc,EAAE,oBAAoB,EACpC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,GACtD,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,OAAO,EAAE,YAAY,EACrB,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EAChE,uBAAuB,EAAE,mBAAmB,EAAE,eAAe,EAC7D,YAAY,EAAE,aAAa,GAC5B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,oBAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,GAChE,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EAAE,cAAc,EAAE,qBAAqB,GACtD,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EACV,cAAc,EAAE,oBAAoB,EAAE,wBAAwB,GAC/D,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,aAAa,EACb,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,UAAU,EACV,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,10 +1,10 @@
 // Barrel export for @roam-research/roam-tools-core
+//
+// Core is transport-agnostic — it does NOT export RoamClient, the
+// ~/.roam-tools.json reader, or the connect command. Those live in
+// @roam-research/roam-tools-local. Hosted MCP transports depend on this
+// package directly and supply their own resolveGraph + createClient via
+// routeToolCall's options.
 export { GraphConfigSchema, RoamMcpConfigSchema, ErrorCodes, RoamError, CONFIG_VERSION, EXPECTED_API_VERSION, textResult, imageResult, errorResult, getErrorMessage, } from "./types.js";
-// Client
-export { RoamClient } from "./client.js";
-// Graph resolution and config management
-export { getPort, resolveGraph, saveGraphToConfig, removeGraphFromConfig, updateGraphTokenStatus, getConfiguredGraphsSafe, getConfiguredGraphs, findGraphConfig, getMcpConfig, getOpenGraphs, } from "./graph-resolver.js";
-// Shared Roam API functions
-export { fetchAvailableGraphs, requestToken, sleep, openRoamApp, slugify, } from "./roam-api.js";
-// Tool definitions and routing
-export { tools, findTool, routeToolCall } from "./tools.js";
+// Tool definitions, helpers, and routing
+export { tools, findTool, routeToolCall, contentTools, dataTools, desktopUiTools, defineTool, defineStandaloneTool, } from "./tools.js";

package/dist/operations/blocks.d.ts

@@ -1,6 +1,5 @@
 import { z } from "zod";
-import type { RoamClient } from "../client.js";
-import type { CallToolResult } from "../types.js";
+import type { CallToolResult, RoamActionClient } from "../types.js";
 export declare const CreateBlockSchema: z.ZodObject<{
     parentUid: z.ZodOptional<z.ZodString>;
     pageTitle: z.ZodOptional<z.ZodString>;
@@ -38,16 +37,22 @@ export declare const UpdateBlockSchema: z.ZodObject<{
     string: z.ZodOptional<z.ZodString>;
     open: z.ZodOptional<z.ZodBoolean>;
     heading: z.ZodOptional<z.ZodNumber>;
+    childrenViewType: z.ZodOptional<z.ZodEnum<["bullet", "numbered", "document"]>>;
+    textAlign: z.ZodOptional<z.ZodEnum<["left", "center", "right", "justify"]>>;
 }, "strip", z.ZodTypeAny, {
     uid: string;
     string?: string | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
     open?: boolean | undefined;
     heading?: number | undefined;
+    textAlign?: "left" | "center" | "right" | "justify" | undefined;
 }, {
     uid: string;
     string?: string | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
     open?: boolean | undefined;
     heading?: number | undefined;
+    textAlign?: "left" | "center" | "right" | "justify" | undefined;
 }>;
 export declare const DeleteBlockSchema: z.ZodObject<{
     uid: z.ZodString;
@@ -80,25 +85,25 @@ export declare const GetBacklinksSchema: z.ZodObject<{
     includePath: z.ZodOptional<z.ZodBoolean>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
     sort?: "created-date" | "edited-date" | "daily-note-date" | undefined;
+    search?: string | undefined;
     uid?: string | undefined;
-    title?: string | undefined;
-    sortOrder?: "asc" | "desc" | undefined;
-    includePath?: boolean | undefined;
+    maxDepth?: number | undefined;
     offset?: number | undefined;
     limit?: number | undefined;
-    maxDepth?: number | undefined;
-    search?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+    includePath?: boolean | undefined;
 }, {
+    title?: string | undefined;
     sort?: "created-date" | "edited-date" | "daily-note-date" | undefined;
+    search?: string | undefined;
     uid?: string | undefined;
-    title?: string | undefined;
-    sortOrder?: "asc" | "desc" | undefined;
-    includePath?: boolean | undefined;
+    maxDepth?: number | undefined;
     offset?: number | undefined;
     limit?: number | undefined;
-    maxDepth?: number | undefined;
-    search?: string | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+    includePath?: boolean | undefined;
 }>;
 export type CreateBlockParams = z.infer<typeof CreateBlockSchema>;
 export type GetBlockParams = z.infer<typeof GetBlockSchema>;
@@ -121,12 +126,12 @@ export interface GetBacklinksResponse {
     total: number;
     results: BacklinkResult[];
 }
-export declare function createBlock(client: RoamClient, params: CreateBlockParams): Promise<CallToolResult>;
-export declare function getBlock(client: RoamClient, params: GetBlockParams): Promise<CallToolResult>;
-export declare function updateBlock(client: RoamClient, params: UpdateBlockParams): Promise<CallToolResult>;
-export declare function deleteBlock(client: RoamClient, params: DeleteBlockParams): Promise<CallToolResult>;
-export declare function moveBlock(client: RoamClient, params: MoveBlockParams): Promise<CallToolResult>;
-export declare function getBacklinks(client: RoamClient, params: GetBacklinksParams): Promise<CallToolResult>;
+export declare function createBlock(client: RoamActionClient, params: CreateBlockParams): Promise<CallToolResult>;
+export declare function getBlock(client: RoamActionClient, params: GetBlockParams): Promise<CallToolResult>;
+export declare function updateBlock(client: RoamActionClient, params: UpdateBlockParams): Promise<CallToolResult>;
+export declare function deleteBlock(client: RoamActionClient, params: DeleteBlockParams): Promise<CallToolResult>;
+export declare function moveBlock(client: RoamActionClient, params: MoveBlockParams): Promise<CallToolResult>;
+export declare function getBacklinks(client: RoamActionClient, params: GetBacklinksParams): Promise<CallToolResult>;
 export declare const AddCommentSchema: z.ZodObject<{
     blockUid: z.ZodString;
     comment: z.ZodOptional<z.ZodString>;
@@ -165,6 +170,6 @@ export interface GetCommentsResponse {
     total: number;
     comments: CommentResult[];
 }
-export declare function addComment(client: RoamClient, params: AddCommentParams): Promise<CallToolResult>;
-export declare function getComments(client: RoamClient, params: GetCommentsParams): Promise<CallToolResult>;
+export declare function addComment(client: RoamActionClient, params: AddCommentParams): Promise<CallToolResult>;
+export declare function getComments(client: RoamActionClient, params: GetCommentsParams): Promise<CallToolResult>;
 //# sourceMappingURL=blocks.d.ts.map

package/dist/operations/blocks.d.ts.map

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

package/dist/operations/blocks.js

@@ -2,22 +2,46 @@ import { z } from "zod";
 import { textResult, RoamError, ErrorCodes } from "../types.js";
 // Schemas
 export const CreateBlockSchema = z.object({
-    parentUid: z.string().optional().describe("UID of parent block or page. Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
-    pageTitle: z.string().optional().describe("Page title to create block under (creates the page if it doesn't exist). Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
-    dailyNotePage: z.string().regex(/^\d{2}-\d{2}-\d{4}$/, "Must be MM-DD-YYYY format (e.g. '03-17-2026')").optional().describe("Daily note date in MM-DD-YYYY format (e.g. '03-17-2026'). Targets that day's daily note page, creating it if needed. Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
-    nestUnder: z.string().optional().describe("Insert under a direct child block matching this string (matches on the block's string field, including markup like **bold** or [[links]]). If no match exists, creates a new child block with this text first, then inserts under it. Works with parentUid, pageTitle, or dailyNotePage."),
+    parentUid: z
+        .string()
+        .optional()
+        .describe("UID of parent block or page. Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
+    pageTitle: z
+        .string()
+        .optional()
+        .describe("Page title to create block under (creates the page if it doesn't exist). Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
+    dailyNotePage: z
+        .string()
+        .regex(/^\d{2}-\d{2}-\d{4}$/, "Must be MM-DD-YYYY format (e.g. '03-17-2026')")
+        .optional()
+        .describe("Daily note date in MM-DD-YYYY format (e.g. '03-17-2026'). Targets that day's daily note page, creating it if needed. Exactly one of parentUid, pageTitle, or dailyNotePage is required."),
+    nestUnder: z
+        .string()
+        .optional()
+        .describe("Insert under a direct child block matching this string (matches on the block's string field, including markup like **bold** or [[links]]). If no match exists, creates a new child block with this text first, then inserts under it. Works with parentUid, pageTitle, or dailyNotePage."),
     markdown: z.string().describe("Markdown content for the block"),
-    order: z.union([z.coerce.number(), z.enum(["first", "last"])]).optional().describe("Position (number, 'first', or 'last'). Defaults to 'last'"),
+    order: z
+        .union([z.coerce.number(), z.enum(["first", "last"])])
+        .optional()
+        .describe("Position (number, 'first', or 'last'). Defaults to 'last'"),
 });
 export const GetBlockSchema = z.object({
     uid: z.string().describe("Block UID"),
-    maxDepth: z.coerce.number().optional().describe("Max depth of children to include in markdown (omit for full tree)"),
+    maxDepth: z.coerce
+        .number()
+        .optional()
+        .describe("Max depth of children to include in markdown (omit for full tree)"),
 });
 export const UpdateBlockSchema = z.object({
     uid: z.string().describe("Block UID"),
     string: z.string().optional().describe("New text content"),
     open: z.boolean().optional().describe("Collapse state"),
     heading: z.coerce.number().optional().describe("Heading level (0-3)"),
+    childrenViewType: z
+        .enum(["bullet", "numbered", "document"])
+        .optional()
+        .describe("How children are displayed (bullet, numbered, or document)"),
+    textAlign: z.enum(["left", "center", "right", "justify"]).optional().describe("Text alignment"),
 });
 export const DeleteBlockSchema = z.object({
     uid: z.string().describe("Block UID to delete"),
@@ -25,22 +49,36 @@ export const DeleteBlockSchema = z.object({
 export const MoveBlockSchema = z.object({
     uid: z.string().describe("Block UID to move"),
     parentUid: z.string().describe("UID of the new parent block or page"),
-    order: z.union([z.coerce.number(), z.enum(["first", "last"])]).describe("Position in the new parent (number, 'first', or 'last')"),
+    order: z
+        .union([z.coerce.number(), z.enum(["first", "last"])])
+        .describe("Position in the new parent (number, 'first', or 'last')"),
 });
 export const GetBacklinksSchema = z.object({
     uid: z.string().optional().describe("UID of page or block (required if no title)"),
     title: z.string().optional().describe("Page title (required if no uid)"),
     offset: z.coerce.number().optional().describe("Skip first N results (default: 0)"),
     limit: z.coerce.number().optional().describe("Max results to return (default: 20)"),
-    sort: z.enum(["created-date", "edited-date", "daily-note-date"]).optional().describe("Sort order (default: created-date)"),
+    sort: z
+        .enum(["created-date", "edited-date", "daily-note-date"])
+        .optional()
+        .describe("Sort order (default: created-date)"),
     sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort direction (default: desc)"),
-    search: z.string().optional().describe("Filter results by text match (searches block, parents, children, page title)"),
-    includePath: z.boolean().optional().describe("Include breadcrumb path to each result (default: true)"),
-    maxDepth: z.coerce.number().optional().describe("Max depth of children to include in markdown (default: 2)"),
+    search: z
+        .string()
+        .optional()
+        .describe("Filter results by text match (searches block, parents, children, page title)"),
+    includePath: z
+        .boolean()
+        .optional()
+        .describe("Include breadcrumb path to each result (default: true)"),
+    maxDepth: z.coerce
+        .number()
+        .optional()
+        .describe("Max depth of children to include in markdown (default: 2)"),
 });
 export async function createBlock(client, params) {
     // Validate: exactly one of parentUid, pageTitle, or dailyNotePage
-    const targets = [params.parentUid, params.pageTitle, params.dailyNotePage].filter(v => v !== undefined);
+    const targets = [params.parentUid, params.pageTitle, params.dailyNotePage].filter((v) => v !== undefined);
     if (targets.length === 0) {
         throw new RoamError("Either 'parentUid', 'pageTitle', or 'dailyNotePage' is required to specify where to create the block", ErrorCodes.VALIDATION_ERROR);
     }
@@ -82,6 +120,10 @@ export async function updateBlock(client, params) {
         block.open = params.open;
     if (params.heading !== undefined)
         block.heading = params.heading;
+    if (params.childrenViewType !== undefined)
+        block["children-view-type"] = params.childrenViewType;
+    if (params.textAlign !== undefined)
+        block["text-align"] = params.textAlign;
     await client.call("data.block.update", [{ block }]);
     return textResult({ success: true });
 }
@@ -129,12 +171,21 @@ export async function getBacklinks(client, params) {
 // --- Comments ---
 export const AddCommentSchema = z.object({
     blockUid: z.string().describe("UID of the block to comment on"),
-    comment: z.string().optional().describe("Plain text comment (single block, editable later via update_block). Required if commentMarkdown not provided. Preferred for simple comments."),
-    commentMarkdown: z.string().optional().describe("Markdown comment parsed into multiple blocks. Required if comment not provided. Use only when you need structure (lists, headings). Harder to edit later."),
+    comment: z
+        .string()
+        .optional()
+        .describe("Plain text comment (single block, editable later via update_block). Required if commentMarkdown not provided. Preferred for simple comments."),
+    commentMarkdown: z
+        .string()
+        .optional()
+        .describe("Markdown comment parsed into multiple blocks. Required if comment not provided. Use only when you need structure (lists, headings). Harder to edit later."),
 });
 export const GetCommentsSchema = z.object({
     blockUid: z.string().describe("UID of the block to get comments for"),
-    maxDepth: z.coerce.number().optional().describe("Max depth of children to include in each comment's markdown (omit for full tree)"),
+    maxDepth: z.coerce
+        .number()
+        .optional()
+        .describe("Max depth of children to include in each comment's markdown (omit for full tree)"),
 });
 export async function addComment(client, params) {
     // Validate: exactly one of comment or commentMarkdown must be provided

package/dist/operations/datalog.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { CallToolResult, RoamActionClient } from "../types.js";
+export declare const DatalogQuerySchema: z.ZodObject<{
+    query: z.ZodString;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    inputs?: unknown[] | undefined;
+}, {
+    query: string;
+    inputs?: unknown[] | undefined;
+}>;
+export type DatalogQueryParams = z.infer<typeof DatalogQuerySchema>;
+export declare function datalogQuery(client: RoamActionClient, params: DatalogQueryParams): Promise<CallToolResult>;
+//# sourceMappingURL=datalog.d.ts.map

package/dist/operations/datalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datalog.d.ts","sourceRoot":"","sources":["../../src/operations/datalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpE,eAAO,MAAM,kBAAkB;;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,cAAc,CAAC,CAIzB"}

package/dist/operations/datalog.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { textResult } from "../types.js";
+export const DatalogQuerySchema = z.object({
+    query: z
+        .string()
+        .describe("Datalog query string (e.g., '[:find ?title :where [?e :node/title ?title]]')"),
+    inputs: z
+        .array(z.unknown())
+        .optional()
+        .describe("Input parameters for the query, corresponding to :in clause bindings after $"),
+});
+export async function datalogQuery(client, params) {
+    const args = params.inputs ? [params.query, ...params.inputs] : [params.query];
+    const response = await client.call("q", args);
+    return textResult(response.result ?? []);
+}

package/dist/operations/files.d.ts

@@ -1,6 +1,5 @@
 import { z } from "zod";
-import type { RoamClient } from "../client.js";
-import type { CallToolResult } from "../types.js";
+import type { CallToolResult, RoamActionClient } from "../types.js";
 export declare const FileGetSchema: z.ZodObject<{
     url: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -16,14 +15,14 @@ export declare const FileUploadSchema: z.ZodObject<{
     filename: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     url?: string | undefined;
-    filePath?: string | undefined;
     base64?: string | undefined;
+    filePath?: string | undefined;
     mimetype?: string | undefined;
     filename?: string | undefined;
 }, {
     url?: string | undefined;
-    filePath?: string | undefined;
     base64?: string | undefined;
+    filePath?: string | undefined;
     mimetype?: string | undefined;
     filename?: string | undefined;
 }>;
@@ -37,7 +36,7 @@ export declare const FileDeleteSchema: z.ZodObject<{
 export type FileGetParams = z.infer<typeof FileGetSchema>;
 export type FileUploadParams = z.infer<typeof FileUploadSchema>;
 export type FileDeleteParams = z.infer<typeof FileDeleteSchema>;
-export declare function getFile(client: RoamClient, params: FileGetParams): Promise<CallToolResult>;
-export declare function uploadFile(client: RoamClient, params: FileUploadParams): Promise<CallToolResult>;
-export declare function deleteFile(client: RoamClient, params: FileDeleteParams): Promise<CallToolResult>;
+export declare function getFile(client: RoamActionClient, params: FileGetParams): Promise<CallToolResult>;
+export declare function uploadFile(client: RoamActionClient, params: FileUploadParams): Promise<CallToolResult>;
+export declare function deleteFile(client: RoamActionClient, params: FileDeleteParams): Promise<CallToolResult>;
 //# sourceMappingURL=files.d.ts.map

package/dist/operations/files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/operations/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAGH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA0GhE,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBhG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiDtG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAGtG"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/operations/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpE,eAAO,MAAM,aAAa;;;;;;EAExB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAkB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAGH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AA+GhE,wBAAsB,OAAO,CAC3B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAiDzB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAGzB"}

package/dist/operations/files.js

@@ -7,11 +7,23 @@ export const FileGetSchema = z.object({
     url: z.string().describe("Firebase storage URL of the file"),
 });
 export const FileUploadSchema = z.object({
-    filePath: z.string().optional().describe("Local file path (preferred) - server reads the file directly"),
+    filePath: z
+        .string()
+        .optional()
+        .describe("Local file path (preferred) - server reads the file directly"),
     url: z.string().optional().describe("Remote URL to fetch the file from"),
-    base64: z.string().optional().describe("Base64-encoded file data (fallback for sandboxed clients)"),
-    mimetype: z.string().optional().describe("MIME type (e.g., image/png, image/jpeg) - auto-detected if not provided"),
-    filename: z.string().optional().describe("Original filename for reference - derived from path/url if not provided"),
+    base64: z
+        .string()
+        .optional()
+        .describe("Base64-encoded file data (fallback for sandboxed clients)"),
+    mimetype: z
+        .string()
+        .optional()
+        .describe("MIME type (e.g., image/png, image/jpeg) - auto-detected if not provided"),
+    filename: z
+        .string()
+        .optional()
+        .describe("Original filename for reference - derived from path/url if not provided"),
 });
 export const FileDeleteSchema = z.object({
     url: z.string().describe("Firebase storage URL of the file to delete"),
@@ -102,7 +114,8 @@ async function fetchRemoteFile(url) {
     // Try Content-Type header first, then extension, then magic bytes
     let mimetype = response.headers.get("content-type")?.split(";")[0];
     if (!mimetype || mimetype === "application/octet-stream") {
-        mimetype = detectMimeTypeFromExtension(urlPath) || detectMimeTypeFromBase64(base64) || undefined;
+        mimetype =
+            detectMimeTypeFromExtension(urlPath) || detectMimeTypeFromBase64(base64) || undefined;
     }
     if (!mimetype) {
         throw new Error(`Could not detect MIME type for URL: ${url}`);

package/dist/operations/navigation.d.ts

@@ -1,32 +1,31 @@
 import { z } from "zod";
-import type { RoamClient } from "../client.js";
-import type { CallToolResult } from "../types.js";
+import type { CallToolResult, RoamActionClient } from "../types.js";
 export declare const GetOpenWindowsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const GetSelectionSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 export declare const OpenMainWindowSchema: z.ZodObject<{
     uid: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    uid?: string | undefined;
     title?: string | undefined;
-}, {
     uid?: string | undefined;
+}, {
     title?: string | undefined;
+    uid?: string | undefined;
 }>;
 export declare const OpenSidebarSchema: z.ZodObject<{
     uid: z.ZodString;
     type: z.ZodOptional<z.ZodEnum<["block", "outline", "mentions"]>>;
 }, "strip", z.ZodTypeAny, {
     uid: string;
-    type?: "block" | "outline" | "mentions" | undefined;
+    type?: "mentions" | "block" | "outline" | undefined;
 }, {
     uid: string;
-    type?: "block" | "outline" | "mentions" | undefined;
+    type?: "mentions" | "block" | "outline" | undefined;
 }>;
 export type OpenMainWindowParams = z.infer<typeof OpenMainWindowSchema>;
 export type OpenSidebarParams = z.infer<typeof OpenSidebarSchema>;
-export declare function getOpenWindows(client: RoamClient): Promise<CallToolResult>;
-export declare function getSelection(client: RoamClient): Promise<CallToolResult>;
-export declare function openMainWindow(client: RoamClient, params: OpenMainWindowParams): Promise<CallToolResult>;
-export declare function openSidebar(client: RoamClient, params: OpenSidebarParams): Promise<CallToolResult>;
+export declare function getOpenWindows(client: RoamActionClient): Promise<CallToolResult>;
+export declare function getSelection(client: RoamActionClient): Promise<CallToolResult>;
+export declare function openMainWindow(client: RoamActionClient, params: OpenMainWindowParams): Promise<CallToolResult>;
+export declare function openSidebar(client: RoamActionClient, params: OpenSidebarParams): Promise<CallToolResult>;
 //# sourceMappingURL=navigation.d.ts.map

package/dist/operations/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/operations/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAkE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlH,eAAO,MAAM,oBAAoB,gDAAe,CAAC;AAEjD,eAAO,MAAM,kBAAkB,gDAAe,CAAC;AAE/C,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAShF;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAS9E;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ9G;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAUxG"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/operations/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAKV,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAIrB,eAAO,MAAM,oBAAoB,gDAAe,CAAC;AAEjD,eAAO,MAAM,kBAAkB,gDAAe,CAAC;AAE/C,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAM5B,CAAC;AAGH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAStF;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CASpF;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,cAAc,CAAC,CAUzB"}

package/dist/operations/navigation.js

@@ -9,7 +9,10 @@ export const OpenMainWindowSchema = z.object({
 });
 export const OpenSidebarSchema = z.object({
     uid: z.string().describe("UID of page or block"),
-    type: z.enum(["block", "outline", "mentions"]).optional().describe("View type (default: outline)"),
+    type: z
+        .enum(["block", "outline", "mentions"])
+        .optional()
+        .describe("View type (default: outline)"),
 });
 export async function getOpenWindows(client) {
     const [mainResponse, sidebarResponse] = await Promise.all([

package/dist/operations/pages.d.ts

@@ -1,30 +1,32 @@
 import { z } from "zod";
-import type { RoamClient } from "../client.js";
-import type { CallToolResult } from "../types.js";
+import type { CallToolResult, RoamActionClient } from "../types.js";
 export declare const CreatePageSchema: z.ZodObject<{
     title: z.ZodString;
     markdown: z.ZodOptional<z.ZodString>;
     uid: z.ZodOptional<z.ZodString>;
+    childrenViewType: z.ZodOptional<z.ZodEnum<["document", "bullet", "numbered"]>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    uid?: string | undefined;
     markdown?: string | undefined;
+    uid?: string | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
 }, {
     title: string;
-    uid?: string | undefined;
     markdown?: string | undefined;
+    uid?: string | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
 }>;
 export declare const GetPageSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     uid: z.ZodOptional<z.ZodString>;
     maxDepth: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    uid?: string | undefined;
     title?: string | undefined;
+    uid?: string | undefined;
     maxDepth?: number | undefined;
 }, {
-    uid?: string | undefined;
     title?: string | undefined;
+    uid?: string | undefined;
     maxDepth?: number | undefined;
 }>;
 export declare const DeletePageSchema: z.ZodObject<{
@@ -42,12 +44,12 @@ export declare const UpdatePageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     uid: string;
     title?: string | undefined;
-    childrenViewType?: "document" | "bullet" | "numbered" | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
     mergePages?: boolean | undefined;
 }, {
     uid: string;
     title?: string | undefined;
-    childrenViewType?: "document" | "bullet" | "numbered" | undefined;
+    childrenViewType?: "bullet" | "numbered" | "document" | undefined;
     mergePages?: boolean | undefined;
 }>;
 export declare const GetGuidelinesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
@@ -55,9 +57,9 @@ export type CreatePageParams = z.infer<typeof CreatePageSchema>;
 export type GetPageParams = z.infer<typeof GetPageSchema>;
 export type DeletePageParams = z.infer<typeof DeletePageSchema>;
 export type UpdatePageParams = z.infer<typeof UpdatePageSchema>;
-export declare function createPage(client: RoamClient, params: CreatePageParams): Promise<CallToolResult>;
-export declare function getPage(client: RoamClient, params: GetPageParams): Promise<CallToolResult>;
-export declare function deletePage(client: RoamClient, params: DeletePageParams): Promise<CallToolResult>;
-export declare function updatePage(client: RoamClient, params: UpdatePageParams): Promise<CallToolResult>;
-export declare function getGuidelines(client: RoamClient): Promise<CallToolResult>;
+export declare function createPage(client: RoamActionClient, params: CreatePageParams): Promise<CallToolResult>;
+export declare function getPage(client: RoamActionClient, params: GetPageParams): Promise<CallToolResult>;
+export declare function deletePage(client: RoamActionClient, params: DeletePageParams): Promise<CallToolResult>;
+export declare function updatePage(client: RoamActionClient, params: UpdatePageParams): Promise<CallToolResult>;
+export declare function getGuidelines(client: RoamActionClient): Promise<CallToolResult>;
 //# sourceMappingURL=pages.d.ts.map

package/dist/operations/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/operations/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAInE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAIxB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,eAAO,MAAM,mBAAmB,gDAAe,CAAC;AAGhD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQtG;AAED,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAMhG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAGtG;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAUtG;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB/E"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/operations/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIrF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAa3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAa3B,CAAC;AAEH,eAAO,MAAM,mBAAmB,gDAAe,CAAC;AAGhD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CASzB;AAED,wBAAsB,OAAO,CAC3B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,cAAc,CAAC,CAQzB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0BrF"}