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

package/dist/graph-resolver.js

@@ -1,338 +0,0 @@
-// src/core/graph-resolver.ts
-// Stateless config-based graph resolution with token authentication
-import { readFile, writeFile, chmod, stat } from "fs/promises";
-import { homedir } from "os";
-import { join } from "path";
-import { RoamMcpConfigSchema, RoamError, ErrorCodes, CONFIG_VERSION, } from "./types.js";
-// Warning suppression flags (prevent spamming on every tool call)
-let permissionCheckDone = false;
-let dedupWarningShown = false;
-async function getLocalApiConfig() {
-    try {
-        const configFile = join(homedir(), ".roam-local-api.json");
-        const content = await readFile(configFile, "utf-8");
-        return JSON.parse(content);
-    }
-    catch {
-        return { port: 3333 }; // Default port
-    }
-}
-export async function getPort() {
-    const config = await getLocalApiConfig();
-    return config.port;
-}
-// ============================================================================
-// MCP Config Loading (from ~/.roam-tools.json)
-// ============================================================================
-const CONFIG_PATH = join(homedir(), ".roam-tools.json");
-/**
- * Write config file with restricted permissions (owner read/write only).
- */
-async function writeConfigFile(path, data) {
-    await writeFile(path, data, { mode: 0o600 });
-    // Also chmod in case the file already existed with wrong permissions
-    await chmod(path, 0o600);
-}
-/**
- * Check that the config file version is not newer than what this client supports.
- * Must run on raw parsed JSON BEFORE Zod validation — a future version may change
- * the schema structure, and Zod would reject it with a confusing error.
- */
-function checkConfigVersion(parsed) {
-    const version = typeof parsed.version === "number" ? parsed.version : 1;
-    if (version > CONFIG_VERSION) {
-        throw new RoamError(`Your ~/.roam-tools.json (version ${version}) was written by a newer version of Roam tools. ` +
-            `This client only supports config version ${CONFIG_VERSION}. ` +
-            `Please update @roam-research/roam-mcp and @roam-research/roam-cli to the latest version.`, ErrorCodes.CONFIG_TOO_NEW, { configVersion: version, supportedVersion: CONFIG_VERSION });
-    }
-}
-export async function getMcpConfig() {
-    let content;
-    try {
-        content = await readFile(CONFIG_PATH, "utf-8");
-        // Check file permissions (Unix only — skip on Windows)
-        if (!permissionCheckDone) {
-            permissionCheckDone = true;
-            try {
-                const fileStat = await stat(CONFIG_PATH);
-                const mode = fileStat.mode & 0o777;
-                if (mode & 0o077) {
-                    console.error(`[roam-mcp] WARNING: ${CONFIG_PATH} has overly permissive permissions (0${mode.toString(8)}). ` +
-                        `This file contains API tokens and should not be accessible by others. ` +
-                        `Run: chmod 600 ${CONFIG_PATH}`);
-                }
-            }
-            catch {
-                // Ignore permission check errors (e.g., Windows)
-            }
-        }
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            throw new RoamError(`No graphs configured. Use the setup_new_graph tool to connect a Roam graph, ` +
-                `or run the CLI setup command:\n\n` +
-                `  npx @roam-research/roam-cli connect\n\n` +
-                `After connecting, try your request again.`, ErrorCodes.CONFIG_NOT_FOUND);
-        }
-        throw error;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch {
-        throw new RoamError(`Invalid JSON in ${CONFIG_PATH}. Please check the file format.`, ErrorCodes.VALIDATION_ERROR);
-    }
-    checkConfigVersion(parsed);
-    const validated = RoamMcpConfigSchema.safeParse(parsed);
-    if (!validated.success) {
-        const issues = validated.error.issues
-            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
-            .join("\n");
-        throw new RoamError(`Invalid config in ${CONFIG_PATH}:\n${issues}`, ErrorCodes.VALIDATION_ERROR);
-    }
-    // Validate nickname uniqueness (case-insensitive)
-    const nicknames = new Set();
-    for (const graph of validated.data.graphs) {
-        const lowerNickname = graph.nickname.toLowerCase();
-        if (nicknames.has(lowerNickname)) {
-            throw new RoamError(`Duplicate nickname "${graph.nickname}" in config. Nicknames must be unique (case-insensitive).`, ErrorCodes.VALIDATION_ERROR);
-        }
-        nicknames.add(lowerNickname);
-    }
-    // Handle same-name collisions: if both hosted and offline exist with same name, keep hosted
-    const graphsByName = new Map();
-    for (const graph of validated.data.graphs) {
-        const existing = graphsByName.get(graph.name);
-        if (existing) {
-            if (!dedupWarningShown) {
-                dedupWarningShown = true;
-                // If existing is hosted, skip the new one (regardless of type)
-                // If existing is offline and new is hosted, replace with hosted
-                if (existing.type === "hosted") {
-                    console.error(`[roam-mcp] Warning: Ignoring duplicate graph "${graph.name}" (${graph.type}), using hosted version`);
-                }
-                else if (graph.type === "hosted") {
-                    console.error(`[roam-mcp] Warning: Replacing offline graph "${graph.name}" with hosted version`);
-                }
-                else {
-                    console.error(`[roam-mcp] Warning: Ignoring duplicate offline graph "${graph.name}"`);
-                }
-            }
-            // Apply dedup logic regardless of whether warning was shown
-            if (existing.type === "hosted") {
-                continue;
-            }
-            else if (graph.type === "hosted") {
-                graphsByName.set(graph.name, graph);
-            }
-            // else: both offline, skip the duplicate (continue already handled hosted case)
-        }
-        else {
-            graphsByName.set(graph.name, graph);
-        }
-    }
-    // Rebuild graphs array with deduplication applied
-    return { version: validated.data.version ?? 1, graphs: Array.from(graphsByName.values()) };
-}
-// ============================================================================
-// Config Writing Functions
-// ============================================================================
-/**
- * Read the raw config file for write operations (no dedup, but validates with Zod).
- * Returns empty config if file doesn't exist (so saveGraphToConfig can create the initial file).
- */
-async function readRawConfig() {
-    let content;
-    try {
-        content = await readFile(CONFIG_PATH, "utf-8");
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
-            return { version: CONFIG_VERSION, graphs: [] };
-        }
-        throw error;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch {
-        throw new RoamError(`Invalid JSON in ${CONFIG_PATH}. Please check the file format.`, ErrorCodes.VALIDATION_ERROR);
-    }
-    checkConfigVersion(parsed);
-    const validated = RoamMcpConfigSchema.safeParse(parsed);
-    if (!validated.success) {
-        const issues = validated.error.issues
-            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
-            .join("\n");
-        throw new RoamError(`Invalid config in ${CONFIG_PATH}:\n${issues}`, ErrorCodes.VALIDATION_ERROR);
-    }
-    return validated.data;
-}
-/**
- * Save a graph configuration to ~/.roam-tools.json
- * If a graph with the same name+type exists, it will be updated.
- * Otherwise, the graph will be added.
- */
-export async function saveGraphToConfig(newGraph) {
-    const config = await readRawConfig();
-    // Check for nickname collision (case-insensitive)
-    const existingNickname = config.graphs.find((g) => g.nickname.toLowerCase() === newGraph.nickname.toLowerCase() &&
-        !(g.name === newGraph.name && g.type === newGraph.type));
-    if (existingNickname) {
-        throw new RoamError(`Nickname "${newGraph.nickname}" is already used by graph "${existingNickname.name}". Please choose a different nickname.`, ErrorCodes.VALIDATION_ERROR);
-    }
-    // Check for existing graph with same name+type
-    const existingIndex = config.graphs.findIndex((g) => g.name === newGraph.name && g.type === newGraph.type);
-    if (existingIndex >= 0) {
-        config.graphs[existingIndex] = newGraph; // Update existing
-    }
-    else {
-        config.graphs.push(newGraph); // Add new
-    }
-    const output = { version: CONFIG_VERSION, graphs: config.graphs };
-    await writeConfigFile(CONFIG_PATH, JSON.stringify(output, null, 2));
-}
-/**
- * Remove a graph from ~/.roam-tools.json by nickname
- */
-export async function removeGraphFromConfig(nickname) {
-    const config = await readRawConfig();
-    const lowerNickname = nickname.toLowerCase();
-    const initialLength = config.graphs.length;
-    config.graphs = config.graphs.filter((g) => g.nickname.toLowerCase() !== lowerNickname);
-    if (config.graphs.length === initialLength) {
-        return false; // Graph not found
-    }
-    const output = { version: CONFIG_VERSION, graphs: config.graphs };
-    await writeConfigFile(CONFIG_PATH, JSON.stringify(output, null, 2));
-    return true;
-}
-/**
- * Update a graph's access level and/or token status in config.
- * No-ops if nothing changed (avoids unnecessary disk writes).
- */
-export async function updateGraphTokenStatus(nickname, updates) {
-    const config = await readRawConfig();
-    const graph = config.graphs.find((g) => g.nickname.toLowerCase() === nickname.toLowerCase());
-    if (!graph)
-        return;
-    let changed = false;
-    if (updates.accessLevel !== undefined && graph.accessLevel !== updates.accessLevel) {
-        graph.accessLevel = updates.accessLevel;
-        changed = true;
-    }
-    if (updates.lastKnownTokenStatus !== undefined && graph.lastKnownTokenStatus !== updates.lastKnownTokenStatus) {
-        graph.lastKnownTokenStatus = updates.lastKnownTokenStatus;
-        changed = true;
-    }
-    if (!changed)
-        return;
-    const output = { version: CONFIG_VERSION, graphs: config.graphs };
-    await writeConfigFile(CONFIG_PATH, JSON.stringify(output, null, 2));
-}
-/**
- * Get all configured graphs (returns empty array if config doesn't exist)
- * Unlike getMcpConfig(), this doesn't throw if config is missing.
- */
-export async function getConfiguredGraphsSafe() {
-    try {
-        const config = await readRawConfig();
-        return config.graphs;
-    }
-    catch {
-        return [];
-    }
-}
-// ============================================================================
-// Graph Lookup Functions
-// ============================================================================
-/**
- * Find a graph config by nickname (case-insensitive) or name
- */
-export async function findGraphConfig(nameOrNickname) {
-    const config = await getMcpConfig();
-    const lower = nameOrNickname.toLowerCase();
-    // First try nickname (case-insensitive)
-    const byNickname = config.graphs.find((g) => g.nickname.toLowerCase() === lower);
-    if (byNickname)
-        return byNickname;
-    // Fall back to exact name match
-    return config.graphs.find((g) => g.name === nameOrNickname);
-}
-/**
- * Get list of all configured graphs (for list_graphs tool and error messages)
- */
-export async function getConfiguredGraphs() {
-    const config = await getMcpConfig();
-    return config.graphs.map((g) => ({
-        nickname: g.nickname,
-        name: g.name,
-        accessLevel: g.accessLevel || "full",
-        ...(g.lastKnownTokenStatus ? { lastKnownTokenStatus: g.lastKnownTokenStatus } : {}),
-    }));
-}
-// ============================================================================
-// Graph Resolution
-// ============================================================================
-/**
- * Resolve which graph to use and return full config.
- * Stateless: explicit param → single configured graph → error
- */
-export async function resolveGraph(providedGraph) {
-    const config = await getMcpConfig();
-    // 1. Explicit graph parameter (by nickname or name)
-    if (providedGraph) {
-        const graphConfig = await findGraphConfig(providedGraph);
-        if (!graphConfig) {
-            throw new RoamError(`Graph "${providedGraph}" not found in config. Available graph nicknames are listed below.`, ErrorCodes.GRAPH_NOT_CONFIGURED, {
-                available_graphs: await getConfiguredGraphs(),
-                instruction: "Pass the 'nickname' value as the graph parameter. After identifying which graph to use, ALWAYS call get_graph_guidelines next — it returns essential context and orientation for the session.",
-            });
-        }
-        return {
-            name: graphConfig.name,
-            type: graphConfig.type,
-            token: graphConfig.token,
-            nickname: graphConfig.nickname,
-            accessLevel: graphConfig.accessLevel,
-            lastKnownTokenStatus: graphConfig.lastKnownTokenStatus,
-        };
-    }
-    // 2. Auto-select if exactly one graph configured
-    if (config.graphs.length === 1) {
-        const graphConfig = config.graphs[0];
-        return {
-            name: graphConfig.name,
-            type: graphConfig.type,
-            token: graphConfig.token,
-            nickname: graphConfig.nickname,
-            accessLevel: graphConfig.accessLevel,
-            lastKnownTokenStatus: graphConfig.lastKnownTokenStatus,
-        };
-    }
-    // 3. Multiple graphs - require explicit selection
-    throw new RoamError("Multiple graphs configured. Pass a graph nickname as the graph parameter to specify which graph to use.", ErrorCodes.GRAPH_NOT_SELECTED, {
-        available_graphs: await getConfiguredGraphs(),
-        instruction: "Pass the 'nickname' value as the graph parameter. After identifying which graph to use, ALWAYS call get_graph_guidelines next — it returns essential context and orientation for the session.",
-    });
-}
-/**
- * Fetch list of open graphs from Roam's Local API.
- * Note: This is NOT used for graph resolution in v2.0.0.
- * It's kept for potential future use (e.g., showing which graphs are open).
- */
-export async function getOpenGraphs() {
-    const port = await getPort();
-    const url = `http://127.0.0.1:${port}/api/graphs/open`;
-    const response = await fetch(url, {
-        method: "GET",
-        headers: { "Content-Type": "application/json" },
-    });
-    const data = (await response.json());
-    if (!data.success) {
-        throw new RoamError(data.error || "Failed to get open graphs", ErrorCodes.CONNECTION_FAILED);
-    }
-    return (data.result || []).map((g) => ({ name: g.name, type: g.type }));
-}

package/dist/operations/graphs.d.ts

@@ -1,26 +0,0 @@
-import { z } from "zod";
-import type { CallToolResult } from "../types.js";
-export declare const ListGraphsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-export declare const SetupNewGraphSchema: z.ZodObject<{
-    graph: z.ZodOptional<z.ZodString>;
-    nickname: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    nickname?: string | undefined;
-    graph?: string | undefined;
-}, {
-    nickname?: string | undefined;
-    graph?: string | undefined;
-}>;
-export type ListGraphsParams = z.infer<typeof ListGraphsSchema>;
-export type SetupNewGraphParams = z.infer<typeof SetupNewGraphSchema>;
-/**
- * List all configured graphs with their nicknames.
- */
-export declare function listGraphs(): Promise<CallToolResult>;
-/**
- * Set up a new Roam graph connection, or list available graphs.
- * Call without arguments to list available graphs from Roam Desktop.
- * Call with graph + nickname to request a token and save the configuration.
- */
-export declare function setupNewGraph(args: SetupNewGraphParams): Promise<CallToolResult>;
-//# sourceMappingURL=graphs.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"graphs.d.ts","sourceRoot":"","sources":["../../src/operations/graphs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsBlD,eAAO,MAAM,gBAAgB,gDAAe,CAAC;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;;;EAoB9B,CAAC;AAMH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMtE;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAmB1D;AAqDD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,cAAc,CAAC,CAiKzB"}

package/dist/operations/graphs.js

@@ -1,214 +0,0 @@
-// src/core/operations/graphs.ts
-// Graph management operations
-import { z } from "zod";
-import { textResult, RoamError, ErrorCodes } from "../types.js";
-import { getConfiguredGraphs, getConfiguredGraphsSafe, getPort, saveGraphToConfig, } from "../graph-resolver.js";
-import { fetchAvailableGraphs, requestToken, sleep, openRoamApp, slugify, } from "../roam-api.js";
-// ============================================================================
-// Schemas
-// ============================================================================
-export const ListGraphsSchema = z.object({});
-export const SetupNewGraphSchema = z.object({
-    graph: z
-        .string()
-        .regex(/^[A-Za-z0-9_-]+$/, "Graph name must contain only letters, numbers, hyphens, and underscores")
-        .optional()
-        .describe("The canonical Roam graph name. Omit graph and nickname to list available graphs."),
-    nickname: z
-        .string()
-        .min(1, "Nickname must not be empty")
-        .optional()
-        .describe("A short, memorable label describing what this graph is for (e.g. 'my personal graph', 'work notes', 'book club'). " +
-        "Ask the user what they call this graph — use their natural language, not hyphenated format. " +
-        "Do not just copy the graph name. Required when graph is provided."),
-});
-// ============================================================================
-// Operations
-// ============================================================================
-/**
- * List all configured graphs with their nicknames.
- */
-export async function listGraphs() {
-    try {
-        const graphs = await getConfiguredGraphs();
-        return textResult({
-            graphs,
-            instruction: "Pass the 'nickname' value as the graph parameter. After identifying which graph to use, ALWAYS call get_graph_guidelines next — it returns essential context and orientation for the session.",
-            setup: "To connect additional graphs, use the setup_new_graph tool (call it without arguments to see available graphs).",
-        });
-    }
-    catch (error) {
-        if (error instanceof RoamError) {
-            return textResult({
-                error: {
-                    code: error.code,
-                    message: error.message,
-                },
-            });
-        }
-        throw error;
-    }
-}
-/**
- * Dedup available graphs: if same name exists as both hosted and offline, keep hosted.
- * Consistent with getMcpConfig() dedup behavior in graph-resolver.ts.
- */
-function dedupAvailableGraphs(graphs) {
-    const byName = new Map();
-    for (const g of graphs) {
-        const existing = byName.get(g.name);
-        if (existing) {
-            if (g.type === "hosted")
-                byName.set(g.name, g);
-        }
-        else {
-            byName.set(g.name, g);
-        }
-    }
-    return Array.from(byName.values());
-}
-/**
- * Fetch available graphs from Roam Desktop, retrying once if Roam isn't running.
- * Deduplicates by name (hosted takes priority over offline).
- */
-async function fetchAvailableGraphsWithRetry(port) {
-    let raw;
-    try {
-        raw = await fetchAvailableGraphs(port);
-    }
-    catch (error) {
-        const err = error;
-        const isConnectionError = err.cause?.code === "ECONNREFUSED" ||
-            err.message?.includes("fetch failed");
-        if (!isConnectionError) {
-            throw error;
-        }
-        await openRoamApp();
-        await sleep(5000);
-        try {
-            raw = await fetchAvailableGraphs(port);
-        }
-        catch {
-            throw new RoamError("Could not connect to Roam Desktop. Make sure it is running and the Local API is enabled in Settings > Local API.", ErrorCodes.CONNECTION_FAILED);
-        }
-    }
-    return dedupAvailableGraphs(raw);
-}
-/**
- * Set up a new Roam graph connection, or list available graphs.
- * Call without arguments to list available graphs from Roam Desktop.
- * Call with graph + nickname to request a token and save the configuration.
- */
-export async function setupNewGraph(args) {
-    const { graph, nickname: rawNickname } = args;
-    // List mode: no args → return available graphs from Roam Desktop
-    if (!graph) {
-        const port = await getPort();
-        const availableGraphs = await fetchAvailableGraphsWithRetry(port);
-        const configuredGraphs = await getConfiguredGraphsSafe();
-        return textResult({
-            available_graphs: availableGraphs.map((g) => ({
-                name: g.name,
-                type: g.type,
-            })),
-            already_configured: configuredGraphs.map((g) => ({
-                name: g.name,
-                nickname: g.nickname,
-                type: g.type,
-                accessLevel: g.accessLevel,
-                lastKnownTokenStatus: g.lastKnownTokenStatus,
-            })),
-            instruction: "Call setup_new_graph with graph and nickname to connect one of the available graphs.",
-        });
-    }
-    // Setup mode: graph provided, nickname required
-    if (!rawNickname) {
-        throw new RoamError("nickname is required when graph is provided.", ErrorCodes.VALIDATION_ERROR);
-    }
-    // 1. Slugify nickname
-    const nickname = slugify(rawNickname);
-    if (!nickname) {
-        throw new RoamError(`Nickname "${rawNickname}" produces an empty result after converting to kebab-case. Use a nickname with at least one letter or number.`, ErrorCodes.VALIDATION_ERROR);
-    }
-    // 2. Check if graph is already configured
-    const existingGraphs = await getConfiguredGraphsSafe();
-    const matchingConfigs = existingGraphs.filter((g) => g.name === graph);
-    if (matchingConfigs.length > 0) {
-        const allRevoked = matchingConfigs.every((g) => g.lastKnownTokenStatus === "revoked");
-        if (!allRevoked) {
-            // At least one active config — return as already configured
-            return textResult({
-                status: "already_configured",
-                graphs: matchingConfigs.map((g) => ({
-                    name: g.name,
-                    nickname: g.nickname,
-                    type: g.type,
-                    accessLevel: g.accessLevel,
-                    lastKnownTokenStatus: g.lastKnownTokenStatus,
-                })),
-                instruction: "This graph is already configured. Pass the 'nickname' value as the graph parameter. Call get_graph_guidelines before operating on it.",
-            });
-        }
-        // All revoked — fall through to re-request a new token
-    }
-    // 3. Check nickname collision
-    const nicknameCollision = existingGraphs.find((g) => g.nickname.toLowerCase() === nickname.toLowerCase() && g.name !== graph);
-    if (nicknameCollision) {
-        throw new RoamError(`Nickname "${nickname}" is already used by graph "${nicknameCollision.name}". Please choose a different nickname.`, ErrorCodes.VALIDATION_ERROR);
-    }
-    // 4. Get port and fetch available graphs
-    const port = await getPort();
-    const availableGraphs = await fetchAvailableGraphsWithRetry(port);
-    // 5. Find graph type
-    const graphInfo = availableGraphs.find((g) => g.name === graph);
-    if (!graphInfo) {
-        throw new RoamError(`Graph "${graph}" was not found in Roam Desktop. Make sure the graph name is correct and that it is available in the app.`, ErrorCodes.VALIDATION_ERROR, {
-            available_graphs: availableGraphs.map((g) => g.name),
-        });
-    }
-    // 6. Request token (blocks until user approves/denies in Roam)
-    const result = await requestToken(port, graph, graphInfo.type, "full");
-    // 7. Handle errors
-    if (!result.success || !result.token) {
-        const error = result.error;
-        const errorCode = error && typeof error === "object" ? error.code : undefined;
-        const errorMessage = error
-            ? typeof error === "string"
-                ? error
-                : error.message || "Unknown error"
-            : "Unknown error";
-        switch (errorCode) {
-            case "USER_REJECTED":
-                throw new RoamError("Token request was denied in Roam. The user must approve the request in the Roam desktop app.", ErrorCodes.USER_REJECTED);
-            case "GRAPH_BLOCKED":
-                throw new RoamError("This graph has blocked token requests. Unblock it in Roam Settings > Graph > Local API Tokens.", ErrorCodes.GRAPH_BLOCKED);
-            case "TIMEOUT":
-                throw new RoamError("No response after 5 minutes. Please try again — the user needs to approve the request in the Roam desktop app.", ErrorCodes.TIMEOUT);
-            case "REQUEST_IN_PROGRESS":
-                throw new RoamError("Another token request is already pending for this graph. The user should respond to the existing request in Roam first.", ErrorCodes.REQUEST_IN_PROGRESS);
-            default:
-                throw new RoamError(`Token request failed: ${errorMessage}`, ErrorCodes.INTERNAL_ERROR);
-        }
-    }
-    // 8. Save to config
-    const accessLevel = (result.grantedAccessLevel || "full");
-    const graphConfig = {
-        name: graph,
-        type: graphInfo.type,
-        token: result.token,
-        nickname,
-        accessLevel,
-    };
-    await saveGraphToConfig(graphConfig);
-    // 9. Return success
-    return textResult({
-        status: "connected",
-        graph: {
-            name: graph,
-            nickname,
-            type: graphInfo.type,
-            accessLevel,
-        },
-        instruction: "Graph connected successfully. Call get_graph_guidelines next to understand the graph's conventions before making any changes.",
-    });
-}

package/dist/roam-api.d.ts

@@ -1,32 +0,0 @@
-import type { GraphType } from "./types.js";
-export interface AvailableGraph {
-    name: string;
-    type: GraphType;
-}
-export interface GraphsResponse {
-    success: boolean;
-    result?: AvailableGraph[];
-    error?: string;
-}
-export interface TokenExchangeResponse {
-    success: boolean;
-    token?: string;
-    graphName?: string;
-    graphType?: GraphType;
-    grantedAccessLevel?: string;
-    grantedScopes?: {
-        read?: boolean;
-        append?: boolean;
-        edit?: boolean;
-    };
-    error?: {
-        code?: string;
-        message?: string;
-    } | string;
-}
-export declare function fetchAvailableGraphs(port: number): Promise<AvailableGraph[]>;
-export declare function requestToken(port: number, graph: string, graphType: GraphType, accessLevel: string): Promise<TokenExchangeResponse>;
-export declare function sleep(ms: number): Promise<void>;
-export declare function openRoamApp(): Promise<void>;
-export declare function slugify(input: string): string;
-//# sourceMappingURL=roam-api.d.ts.map

package/dist/roam-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"roam-api.d.ts","sourceRoot":"","sources":["../src/roam-api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACrE,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;CACtD;AAMD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,EAAE,CAAC,CAc3B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAehC;AAMD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/roam-api.js

@@ -1,50 +0,0 @@
-// src/core/roam-api.ts
-// Shared API functions for interacting with Roam's local API.
-// Used by both the CLI (connect command) and the MCP tool (setup_new_graph).
-import open from "open";
-// ============================================================================
-// API Functions
-// ============================================================================
-export async function fetchAvailableGraphs(port) {
-    const url = `http://127.0.0.1:${port}/api/graphs/available`;
-    const response = await fetch(url, {
-        method: "GET",
-        headers: { "Content-Type": "application/json" },
-    });
-    const data = (await response.json());
-    if (!data.success) {
-        throw new Error(data.error || "Failed to get available graphs");
-    }
-    return data.result || [];
-}
-export async function requestToken(port, graph, graphType, accessLevel) {
-    const url = `http://127.0.0.1:${port}/api/graphs/tokens/request`;
-    const response = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            graph,
-            graphType,
-            description: "roam-mcp CLI",
-            accessLevel,
-            ai: true,
-        }),
-    });
-    return (await response.json());
-}
-// ============================================================================
-// Helpers
-// ============================================================================
-export function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export async function openRoamApp() {
-    await open("roam://open");
-}
-export function slugify(input) {
-    return input
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-|-$/g, "")
-        .replace(/-{2,}/g, "-");
-}