Code
Hub
Workspaces
Following
Trending
Connect
MCP
copy
Create free account
hub
/
github.com/Roam-Research/roam-tools
/ functions
Functions
112 in github.com/Roam-Research/roam-tools
⨍
Functions
112
◇
Types & classes
49
↓ 34 callers
Function
textResult
(value: unknown)
packages/core/src/types.ts:12
↓ 25 callers
Function
defineTool
( name: string, description: string, schema: z.ZodObject<T>, action: (client: RoamActionClient, args:
packages/core/src/tools.ts:127
↓ 15 callers
Function
resolveDailyNotePage
(value: string, baseDateStr: string | undefined)
packages/core/src/relative-date.ts:66
↓ 12 callers
Method
call
(action: string, args?: unknown[])
packages/core/src/types.ts:422
↓ 11 callers
Function
isRelativeDateWord
(value: string)
packages/core/src/relative-date.ts:29
↓ 8 callers
Function
annotationsFor
(name: string)
packages/core/test/tool-annotations.test.ts:9
↓ 8 callers
Function
slugify
(input: string)
packages/local/src/roam-api.ts:86
↓ 7 callers
Function
routeToolCall
( toolName: string, args: Record<string, unknown>, options: RouteToolCallOptions, )
packages/core/src/tools.ts:621
↓ 5 callers
Function
getPort
()
packages/local/src/graph-resolver.ts:40
↓ 5 callers
Function
routeToolCall
( toolName: string, args: Record<string, unknown>, options: LocalRouteToolCallOptions = {}, )
packages/local/src/tools.ts:136
↓ 4 callers
Function
detectMimeTypeFromBase64
(base64: string)
packages/core/src/operations/files.ts:52
↓ 4 callers
Function
fetchAvailableGraphs
(port: number)
packages/local/src/roam-api.ts:36
↓ 4 callers
Function
findTool
(name: string)
packages/core/src/tools.ts:464
↓ 4 callers
Function
getConfiguredGraphsSafe
()
packages/local/src/graph-resolver.ts:320
↓ 4 callers
Function
getFlag
(flag: string)
packages/mcp/src/index.ts:37
↓ 4 callers
Function
getMcpConfig
()
packages/local/src/graph-resolver.ts:78
↓ 4 callers
Function
pad2
(n: number)
packages/core/src/relative-date.ts:33
↓ 4 callers
Function
readJson
(path)
scripts/bump-version.mjs:22
↓ 4 callers
Function
readJson
(path)
scripts/check-versions.mjs:10
↓ 4 callers
Function
readRawConfig
* Read the raw config file for write operations (no dedup, but validates with Zod). * Returns empty config if file doesn't exist (so saveGraphToConfi
packages/local/src/graph-resolver.ts:194
↓ 4 callers
Function
stripUndeclaredStructuredContent
( result: CallToolResult, tool: { outputSchema?: unknown }, )
packages/core/src/tools.ts:475
↓ 4 callers
Function
writeJson
(path, data)
scripts/bump-version.mjs:26
↓ 3 callers
Function
getBaseType
(schema: z.ZodTypeAny)
packages/cli/src/index.ts:72
↓ 3 callers
Function
getConfiguredGraphs
()
packages/local/src/graph-resolver.ts:351
↓ 3 callers
Method
getCurrentDate
()
packages/core/src/types.ts:430
↓ 3 callers
Function
localTodayString
(now: Date = new Date())
packages/core/src/relative-date.ts:49
↓ 3 callers
Function
removeGraphFromConfig
(nickname: string)
packages/local/src/graph-resolver.ts:270
↓ 3 callers
Function
withGraphField
* Carry the resolved graph identity as a structured `graph` field rather than a * "Roam graph: <name>" text prefix (which read as block content and m
packages/core/src/tools.ts:494
↓ 3 callers
Function
writeConfigFile
* Write config file with restricted permissions (owner read/write only).
packages/local/src/graph-resolver.ts:54
↓ 2 callers
Function
checkConfigVersion
* 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 vers
packages/local/src/graph-resolver.ts:65
↓ 2 callers
Method
checkResponse
(response: RoamResponse<T>, httpStatus: number)
packages/local/src/client.ts:225
↓ 2 callers
Function
connect
(options: ConnectOptions = {})
packages/local/src/connect.ts:76
↓ 2 callers
Function
defineStandaloneTool
( name: string, description: string, schema: z.ZodObject<T>, action: (args: z.infer<z.ZodObject<T>>) =
packages/core/src/tools.ts:147
↓ 2 callers
Function
detectMimeTypeFromExtension
(filePath: string)
packages/core/src/operations/files.ts:77
↓ 2 callers
Function
fetchAvailableGraphsWithRetry
* Fetch available graphs from Roam Desktop, retrying once if Roam isn't running. * Deduplicates by name (hosted takes priority over offline).
packages/local/src/operations/graphs.ts:99
↓ 2 callers
Function
findTool
(name: string)
packages/local/src/tools.ts:64
↓ 2 callers
Function
getErrorMessage
(error: TokenExchangeResponse["error"])
packages/local/src/connect.ts:61
↓ 2 callers
Method
getPort
()
packages/local/src/client.ts:49
↓ 2 callers
Method
isConnectionError
(error: unknown)
packages/local/src/client.ts:73
↓ 2 callers
Function
openRoamApp
()
packages/local/src/roam-api.ts:82
↓ 2 callers
Function
replaceInFile
(path, pattern, replacement)
scripts/bump-version.mjs:30
↓ 2 callers
Function
requestToken
( port: number, graph: string, graphType: GraphType, accessLevel: string, )
packages/local/src/roam-api.ts:52
↓ 2 callers
Function
roamErrorResult
* Convert a RoamError into a structured error result with isError: true.
packages/core/src/tools.ts:577
↓ 2 callers
Function
saveGraphToConfig
(newGraph: GraphConfig)
packages/local/src/graph-resolver.ts:236
↓ 2 callers
Function
sleep
(ms: number)
packages/local/src/roam-api.ts:78
↓ 1 callers
Function
dedupAvailableGraphs
* Dedup available graphs: if same name exists as both hosted and offline, keep hosted. * Consistent with getMcpConfig() dedup behavior in graph-resol
packages/local/src/operations/graphs.ts:82
↓ 1 callers
Function
enrichResultWithTokenInfo
* Enrich a JSON text result with token info (accessLevel + scopes).
packages/core/src/tools.ts:524
↓ 1 callers
Function
enrichResultWithTokenStatus
* Prepend a token revocation warning to the result.
packages/core/src/tools.ts:555
↓ 1 callers
Function
fetchOpenGraphs
(port: number)
packages/local/src/connect.ts:40
↓ 1 callers
Function
fetchRemoteFile
( url: string, )
packages/core/src/operations/files.ts:122
↓ 1 callers
Function
findGraphConfig
(nameOrNickname: string)
packages/local/src/graph-resolver.ts:336
↓ 1 callers
Method
getAuthErrorGuidance
* Get user-friendly guidance for authentication errors
packages/local/src/client.ts:132
↓ 1 callers
Function
getErrorCode
(error: TokenExchangeResponse["error"])
packages/local/src/connect.ts:67
↓ 1 callers
Function
getExtensionFromMimeType
(mimeType: string)
packages/cli/src/index.ts:14
↓ 1 callers
Function
getLocalApiConfig
()
packages/local/src/graph-resolver.ts:30
↓ 1 callers
Method
getPermissionErrorGuidance
* Get user-friendly guidance for permission errors
packages/local/src/client.ts:167
↓ 1 callers
Method
handleApiError
* Handle API error responses based on HTTP status and error code
packages/local/src/client.ts:187
↓ 1 callers
Method
handleVersionMismatch
(response: RoamResponse<unknown>)
packages/local/src/client.ts:105
↓ 1 callers
Function
hasBooleanType
(schema: z.ZodTypeAny)
packages/cli/src/index.ts:90
↓ 1 callers
Function
hasNumberType
(schema: z.ZodTypeAny)
packages/cli/src/index.ts:80
↓ 1 callers
Function
imageResult
(data: string, mimeType: string)
packages/core/src/types.ts:27
↓ 1 callers
Function
isOptional
(schema: z.ZodTypeAny)
packages/cli/src/index.ts:67
↓ 1 callers
Method
isVersionMismatch
(response: RoamResponse<unknown>)
packages/local/src/client.ts:96
↓ 1 callers
Function
main
()
packages/mcp/src/index.ts:124
↓ 1 callers
Method
openRoamDeepLink
()
packages/local/src/client.ts:64
↓ 1 callers
Function
readLocalFile
( filePath: string, )
packages/core/src/operations/files.ts:102
↓ 1 callers
Function
resolveGraph
(providedGraph?: string)
packages/local/src/graph-resolver.ts:371
↓ 1 callers
Function
roamErrorResult
(error: RoamError)
packages/local/src/tools.ts:111
↓ 1 callers
Method
sleep
(ms: number)
packages/local/src/client.ts:69
↓ 1 callers
Function
toMmDdYyyy
Format a UTC-anchored Date as MM-DD-YYYY.
packages/core/src/relative-date.ts:38
↓ 1 callers
Function
withGraph
(schema: z.ZodObject<T>)
packages/core/src/tools.ts:82
↓ 1 callers
Function
writeImageToTemp
( data: string, mimeType: string, )
packages/cli/src/index.ts:29
Function
addComment
( client: RoamActionClient, params: AddCommentParams, )
packages/core/src/operations/blocks.ts:340
Function
appendToDailyNote
( client: RoamActionClient, params: AppendToDailyNoteParams, )
packages/core/src/operations/blocks.ts:198
Method
call
(action: string, args: unknown[] = [])
packages/local/src/client.ts:283
Method
constructor
( message: string, public readonly code?: ErrorCode | (string & {}), public readonly context?: Rec
packages/core/src/types.ts:160
Method
constructor
(config: RoamClientConfig)
packages/local/src/client.ts:29
Function
createBlock
( client: RoamActionClient, params: CreateBlockParams, )
packages/core/src/operations/blocks.ts:147
Function
createPage
( client: RoamActionClient, params: CreatePageParams, )
packages/core/src/operations/pages.ts:57
Function
datalogQuery
( client: RoamActionClient, params: DatalogQueryParams, )
packages/core/src/operations/datalog.ts:17
Function
defaultCreateClient
(graph: ToolGraph)
packages/local/src/tools.ts:78
Function
defaultResolveGraph
(graph?: string)
packages/local/src/tools.ts:74
Function
deleteBlock
( client: RoamActionClient, params: DeleteBlockParams, )
packages/core/src/operations/blocks.ts:250
Function
deleteFile
( client: RoamActionClient, params: FileDeleteParams, )
packages/core/src/operations/files.ts:227
Function
deletePage
( client: RoamActionClient, params: DeletePageParams, )
packages/core/src/operations/pages.ts:87
Method
doRequest
()
packages/local/src/client.ts:284
Function
errorResult
(message: string)
packages/core/src/types.ts:32
Function
getBacklinks
( client: RoamActionClient, params: GetBacklinksParams, )
packages/core/src/operations/blocks.ts:276
Function
getBlock
( client: RoamActionClient, params: GetBlockParams, )
packages/core/src/operations/blocks.ts:221
Function
getComments
( client: RoamActionClient, params: GetCommentsParams, )
packages/core/src/operations/blocks.ts:371
Method
getCurrentDate
* The machine's local calendar date (yyyy-MM-dd). The npx process shares the * user's clock with the renderer, so machine-local time is the correct
packages/local/src/client.ts:279
Function
getErrorMessage
(error: string | RoamApiError | undefined)
packages/core/src/types.ts:199
Function
getFile
( client: RoamActionClient, params: FileGetParams, )
packages/core/src/operations/files.ts:150
Function
getGuidelines
(client: RoamActionClient)
packages/core/src/operations/pages.ts:110
Function
getOpenGraphs
()
packages/local/src/graph-resolver.ts:443
Function
getOpenWindows
(client: RoamActionClient)
packages/core/src/operations/navigation.ts:34
Function
getPage
( client: RoamActionClient, params: GetPageParams, )
packages/core/src/operations/pages.ts:71
Function
getSelection
(client: RoamActionClient)
packages/core/src/operations/navigation.ts:45
Method
getTokenInfo
()
packages/core/src/types.ts:423
Method
getTokenInfo
* Query the token info endpoint for current permissions. * Best-effort: returns "unknown" on any failure except confirmed revocation.
packages/local/src/client.ts:235
next →
1–100 of 112, ranked by callers