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

package/dist/types.d.ts

@@ -14,8 +14,8 @@ export declare const GraphConfigSchema: z.ZodObject<{
     accessLevel: z.ZodOptional<z.ZodEnum<["read-only", "read-append", "full"]>>;
     lastKnownTokenStatus: z.ZodOptional<z.ZodEnum<["active", "revoked"]>>;
 }, "strip", z.ZodTypeAny, {
-    name: string;
     type: "hosted" | "offline";
+    name: string;
     token: string;
     nickname: string;
     accessLevel?: "read-only" | "read-append" | "full" | undefined;
@@ -39,8 +39,8 @@ export declare const RoamMcpConfigSchema: z.ZodObject<{
         accessLevel: z.ZodOptional<z.ZodEnum<["read-only", "read-append", "full"]>>;
         lastKnownTokenStatus: z.ZodOptional<z.ZodEnum<["active", "revoked"]>>;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         type: "hosted" | "offline";
+        name: string;
         token: string;
         nickname: string;
         accessLevel?: "read-only" | "read-append" | "full" | undefined;
@@ -55,8 +55,8 @@ export declare const RoamMcpConfigSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     graphs: {
-        name: string;
         type: "hosted" | "offline";
+        name: string;
         token: string;
         nickname: string;
         accessLevel?: "read-only" | "read-append" | "full" | undefined;
@@ -75,12 +75,15 @@ export declare const RoamMcpConfigSchema: z.ZodObject<{
     version?: number | undefined;
 }>;
 export type RoamMcpConfig = z.infer<typeof RoamMcpConfigSchema>;
-export interface ResolvedGraph {
+export interface ToolGraph {
     name: string;
     type: GraphType;
-    token: string;
     nickname: string;
     accessLevel?: AccessLevel;
+    token?: string;
+}
+export interface ResolvedGraph extends ToolGraph {
+    token: string;
     lastKnownTokenStatus?: "active" | "revoked";
 }
 export declare const ErrorCodes: {
@@ -277,10 +280,8 @@ export type TokenInfoResult = {
 } | {
     status: "unknown";
 };
-export interface RoamClientConfig {
-    graphName: string;
-    graphType: GraphType;
-    token: string;
-    port?: number;
+export interface RoamActionClient {
+    call<T = unknown>(action: string, args?: unknown[]): Promise<RoamResponse<T>>;
+    getTokenInfo?(): Promise<TokenInfoResult>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -16,14 +16,24 @@ export function errorResult(message) {
 // Graph names can only contain alphanumeric characters, hyphens, and underscores
 const GRAPH_NAME_PATTERN = /^[A-Za-z0-9_-]+$/;
 export const GraphConfigSchema = z.object({
-    name: z.string().regex(GRAPH_NAME_PATTERN, "Graph name can only contain letters, numbers, hyphens, and underscores").describe("Actual graph name in Roam"),
+    name: z
+        .string()
+        .regex(GRAPH_NAME_PATTERN, "Graph name can only contain letters, numbers, hyphens, and underscores")
+        .describe("Actual graph name in Roam"),
     type: z.enum(["hosted", "offline"]).default("hosted").describe("Graph type"),
     token: z.string().startsWith("roam-graph-local-token-").describe("Local API token"),
-    nickname: z.string()
+    nickname: z
+        .string()
         .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "Nickname must be lowercase letters, numbers, and hyphens")
         .describe("Short identifier for the graph (lowercase, hyphens, no spaces)"),
-    accessLevel: z.enum(["read-only", "read-append", "full"]).optional().describe("Token access level"),
-    lastKnownTokenStatus: z.enum(["active", "revoked"]).optional().describe("Token validity status from last sync with Roam"),
+    accessLevel: z
+        .enum(["read-only", "read-append", "full"])
+        .optional()
+        .describe("Token access level"),
+    lastKnownTokenStatus: z
+        .enum(["active", "revoked"])
+        .optional()
+        .describe("Token validity status from last sync with Roam"),
 });
 export const RoamMcpConfigSchema = z.object({
     version: z.number().int().positive().optional(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@roam-research/roam-tools-core",
-  "version": "0.5.0",
-  "description": "Core library for Roam Research tools",
+  "version": "0.6.0",
+  "description": "Transport-agnostic core for Roam Research MCP and CLI tools",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Roam-Research/roam-tools.git",
@@ -15,11 +15,6 @@
       "types": "./dist/index.d.ts",
       "development": "./src/index.ts",
       "import": "./dist/index.js"
-    },
-    "./connect": {
-      "types": "./dist/connect.d.ts",
-      "development": "./src/connect.ts",
-      "import": "./dist/connect.js"
     }
   },
   "files": [
@@ -33,12 +28,14 @@
     "node": ">=18"
   },
   "scripts": {
-    "prepublishOnly": "npm run --prefix ../.. build"
+    "prepublishOnly": "npm run --prefix ../.. build",
+    "test": "vitest run"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.2.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "open": "^11.0.0",
     "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0"
   }
 }

package/dist/client.d.ts

@@ -1,34 +0,0 @@
-import type { RoamResponse, RoamClientConfig, TokenInfoResult } from "./types.js";
-export declare class RoamClient {
-    private graphName;
-    private graphType;
-    private token;
-    private port;
-    constructor(config: RoamClientConfig);
-    private getPort;
-    private openRoamDeepLink;
-    private sleep;
-    private isConnectionError;
-    private isVersionMismatch;
-    private handleVersionMismatch;
-    /**
-     * Get user-friendly guidance for authentication errors
-     */
-    private getAuthErrorGuidance;
-    /**
-     * Get user-friendly guidance for permission errors
-     */
-    private getPermissionErrorGuidance;
-    /**
-     * Handle API error responses based on HTTP status and error code
-     */
-    private handleApiError;
-    private checkResponse;
-    /**
-     * Query the token info endpoint for current permissions.
-     * Best-effort: returns "unknown" on any failure except confirmed revocation.
-     */
-    getTokenInfo(): Promise<TokenInfoResult>;
-    call<T = unknown>(action: string, args?: unknown[]): Promise<RoamResponse<T>>;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAGhB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAQpB,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAuB;gBAEvB,MAAM,EAAE,gBAAgB;YAkBtB,OAAO;YAeP,gBAAgB;YAKhB,KAAK;IAInB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAoBlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IA0CxC,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,OAAO,EAAO,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAuE5B"}

package/dist/client.js

@@ -1,275 +0,0 @@
-// src/core/client.ts
-// v2.0.0 - Token-authenticated Roam Local API client
-import { readFile } from "fs/promises";
-import { homedir } from "os";
-import { join } from "path";
-import open from "open";
-import { EXPECTED_API_VERSION, getErrorMessage, RoamError, ErrorCodes, } from "./types.js";
-export class RoamClient {
-    graphName;
-    graphType;
-    token;
-    port = null;
-    constructor(config) {
-        if (!config.graphName) {
-            throw new Error("graphName is required");
-        }
-        if (!/^[A-Za-z0-9_-]+$/.test(config.graphName)) {
-            throw new Error(`Invalid graph name "${config.graphName}". Graph names can only contain letters, numbers, hyphens, and underscores.`);
-        }
-        if (!config.token) {
-            throw new Error("token is required");
-        }
-        this.graphName = config.graphName;
-        this.graphType = config.graphType;
-        this.token = config.token;
-        if (config.port) {
-            this.port = config.port;
-        }
-    }
-    async getPort() {
-        if (this.port)
-            return this.port;
-        try {
-            const configFile = join(homedir(), ".roam-local-api.json");
-            const content = await readFile(configFile, "utf-8");
-            const config = JSON.parse(content);
-            this.port = config.port;
-            return this.port;
-        }
-        catch {
-            // Default port if file doesn't exist
-            return 3333;
-        }
-    }
-    async openRoamDeepLink() {
-        const deepLink = `roam://#/app/${this.graphName}`;
-        await open(deepLink);
-    }
-    async sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    isConnectionError(error) {
-        if (error instanceof Error) {
-            if (error.message.includes("ECONNREFUSED") ||
-                error.message.includes("fetch failed") ||
-                error.message.includes("network")) {
-                return true;
-            }
-            // Check error.cause for Node fetch network errors
-            if (error.cause && error.cause instanceof Error) {
-                const causeCode = error.cause.code;
-                return (causeCode === "ECONNREFUSED" ||
-                    causeCode === "ECONNRESET" ||
-                    causeCode === "ENOTFOUND" ||
-                    causeCode === "ETIMEDOUT");
-            }
-        }
-        return false;
-    }
-    isVersionMismatch(response) {
-        if (response.success)
-            return false;
-        const error = response.error;
-        if (typeof error === "object" && error !== null) {
-            return error.code === "VERSION_MISMATCH";
-        }
-        return false;
-    }
-    handleVersionMismatch(response) {
-        const serverVersion = response.apiVersion ?? "unknown";
-        let advice = "Please update Roam or the MCP server so versions match.";
-        if (serverVersion !== "unknown") {
-            const [serverMajor, serverMinor] = serverVersion.split(".").map(Number);
-            const [expectedMajor, expectedMinor] = EXPECTED_API_VERSION.split(".").map(Number);
-            if (serverMajor > expectedMajor ||
-                (serverMajor === expectedMajor && serverMinor > expectedMinor)) {
-                advice = "Please update the MCP server.";
-            }
-            else {
-                advice = "Please update Roam.";
-            }
-        }
-        throw new RoamError(`Roam API version mismatch! Roam API: ${serverVersion}, MCP expected: ${EXPECTED_API_VERSION}. ${advice}`, ErrorCodes.VERSION_MISMATCH);
-    }
-    /**
-     * Get user-friendly guidance for authentication errors
-     */
-    getAuthErrorGuidance(code) {
-        const baseMsg = "Authentication failed. ";
-        switch (code) {
-            case ErrorCodes.MISSING_TOKEN:
-                return (baseMsg +
-                    "No API token provided. Please ensure your ~/.roam-tools.json has a valid token.");
-            case ErrorCodes.INVALID_TOKEN_FORMAT:
-                return (baseMsg +
-                    "The token format is invalid. Tokens should start with 'roam-graph-local-token-'.");
-            case ErrorCodes.WRONG_GRAPH_TYPE:
-                return (baseMsg +
-                    "This token is for a different graph type. Check that 'type' matches in your config.");
-            case ErrorCodes.TOKEN_NOT_FOUND:
-                return (baseMsg +
-                    "The token was not recognized. It may have been revoked. Create a new token in Roam Settings > Graph > Local API Tokens.");
-            default:
-                return (baseMsg +
-                    "Please check your token in ~/.roam-tools.json. Create a token in Roam Settings > Graph > Local API Tokens.");
-        }
-    }
-    /**
-     * Get user-friendly guidance for permission errors
-     */
-    getPermissionErrorGuidance(code, error) {
-        switch (code) {
-            case ErrorCodes.INSUFFICIENT_SCOPE:
-                return (`Permission denied. ${error?.message || "This operation requires higher permissions."}\n` +
-                    "Create a token with the required scope in Roam Settings > Graph > Local API Tokens.");
-            case ErrorCodes.SCOPE_EXCEEDS_PERMISSION:
-                return ("The token has more permissions than your user account allows. " +
-                    "Please check your Roam user permissions for this graph.");
-            default:
-                return error?.message || "Access denied. Please check your permissions.";
-        }
-    }
-    /**
-     * Handle API error responses based on HTTP status and error code
-     */
-    handleApiError(status, response) {
-        const error = typeof response.error === "object" ? response.error : undefined;
-        const code = error?.code;
-        const message = getErrorMessage(response.error);
-        // Version mismatch - fatal
-        if (this.isVersionMismatch(response)) {
-            this.handleVersionMismatch(response);
-        }
-        // 401 - Authentication errors
-        if (status === 401) {
-            throw new RoamError(this.getAuthErrorGuidance(code), code);
-        }
-        // 403 - Permission errors
-        if (status === 403) {
-            throw new RoamError(this.getPermissionErrorGuidance(code, error), code);
-        }
-        // 404 - Unknown action
-        if (status === 404) {
-            throw new RoamError(`Unknown API action: ${message}`, ErrorCodes.UNKNOWN_ACTION);
-        }
-        // 500 - Server errors
-        if (status >= 500) {
-            const hint = message.toLowerCase().includes("promise error")
-                ? "\n\nThis can happen if the graph was closed before the request completed, " +
-                    "especially for encrypted graphs, when closed before the password was entered."
-                : "";
-            throw new RoamError(`Server error: ${message}${hint}`, ErrorCodes.INTERNAL_ERROR);
-        }
-        // Other errors
-        throw new RoamError(message, code);
-    }
-    checkResponse(response, httpStatus) {
-        if (!response.success) {
-            this.handleApiError(httpStatus, response);
-        }
-    }
-    /**
-     * Query the token info endpoint for current permissions.
-     * Best-effort: returns "unknown" on any failure except confirmed revocation.
-     */
-    async getTokenInfo() {
-        try {
-            const port = await this.getPort();
-            const response = await fetch(`http://127.0.0.1:${port}/api/graphs/tokens/info`, {
-                method: "POST",
-                headers: { "Content-Type": "application/json" },
-                body: JSON.stringify({
-                    token: this.token,
-                    graph: this.graphName,
-                    type: this.graphType,
-                }),
-            });
-            if (response.status === 401) {
-                try {
-                    const data = (await response.json());
-                    const code = typeof data.error === "object" ? data.error?.code : undefined;
-                    if (code === "TOKEN_NOT_FOUND") {
-                        return { status: "revoked" };
-                    }
-                }
-                catch {
-                    // Couldn't parse 401 body
-                }
-                return { status: "unknown" };
-            }
-            if (!response.ok)
-                return { status: "unknown" };
-            const data = (await response.json());
-            if (!data.success)
-                return { status: "unknown" };
-            return { status: "active", info: data };
-        }
-        catch {
-            return { status: "unknown" };
-        }
-    }
-    async call(action, args = []) {
-        const doRequest = async () => {
-            const port = await this.getPort();
-            // Build URL with graph name and optional type parameter
-            let url = `http://127.0.0.1:${port}/api/${this.graphName}`;
-            if (this.graphType === "offline") {
-                url += "?type=offline";
-            }
-            const response = await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    Authorization: `Bearer ${this.token}`,
-                },
-                body: JSON.stringify({
-                    action,
-                    args,
-                    expectedApiVersion: EXPECTED_API_VERSION,
-                }),
-            });
-            const data = (await response.json());
-            return { data, status: response.status };
-        };
-        try {
-            const { data, status } = await doRequest();
-            this.checkResponse(data, status);
-            return data;
-        }
-        catch (error) {
-            // If connection failed, try opening Roam and retry
-            if (this.isConnectionError(error)) {
-                // Reset cached port so we re-read from config after Roam starts
-                this.port = null;
-                try {
-                    await this.openRoamDeepLink();
-                }
-                catch {
-                    // Best-effort — don't let deep link failure prevent retries
-                }
-                let delay = 500;
-                const maxDelay = 15000;
-                for (let attempt = 0; attempt < 8; attempt += 1) {
-                    await this.sleep(delay);
-                    try {
-                        const { data, status } = await doRequest();
-                        this.checkResponse(data, status);
-                        return data;
-                    }
-                    catch (retryError) {
-                        if (!this.isConnectionError(retryError)) {
-                            throw retryError;
-                        }
-                    }
-                    delay = Math.min(delay * 2, maxDelay);
-                }
-                // All retries exhausted
-                throw new RoamError("Could not connect to Roam Desktop after multiple attempts. " +
-                    "Please restart the Roam desktop app and also this app and then retry again. " +
-                    "If you continue having issues, please let us know at support@roamresearch.com.", ErrorCodes.CONNECTION_FAILED);
-            }
-            throw error;
-        }
-    }
-}

package/dist/connect.d.ts

@@ -1,10 +0,0 @@
-export interface ConnectOptions {
-    graph?: string;
-    nickname?: string;
-    accessLevel?: string;
-    public?: boolean;
-    type?: string;
-    remove?: boolean;
-}
-export declare function connect(options?: ConnectOptions): Promise<void>;
-//# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAgCA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA0CD,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgiBzE"}