obsidian-mcp-server 1.5.6 → 1.5.8

package/README.md

@@ -2,7 +2,7 @@
 
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.8.3-blue.svg)](https://www.typescriptlang.org/)
 [![Model Context Protocol](https://img.shields.io/badge/MCP-1.10.2-green.svg)](https://modelcontextprotocol.io/)
-[![Version](https://img.shields.io/badge/Version-1.5.6-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Version](https://img.shields.io/badge/Version-1.5.8-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Status](https://img.shields.io/badge/Status-Stable-green.svg)]()
 [![GitHub](https://img.shields.io/github/stars/cyanheads/obsidian-mcp-server?style=social)](https://github.com/cyanheads/obsidian-mcp-server)
 
@@ -10,55 +10,55 @@ A Model Context Protocol server designed for LLMs to interact with Obsidian vaul
 
 The Model Context Protocol (MCP) enables AI models to interact with external tools and resources through a standardized interface.
 
-Requires the Local REST API plugin in Obsidian.
+Requires the [Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) in Obsidian.
 
-## Features
+## 📋 Table of Contents
 
-### File Operations
+[Features](#-features) | [Installation](#-installation) | [Configuration](#-configuration) |
+[Tools](#-tools) | [Resources](#-resources) | [Project Structure](#-project-structure) |
+[Contributing](#-contributing) | [Publishing](#-publishing) | [License](#-license)
 
-- Atomic file/directory operations with validation
-- Resource monitoring and cleanup
-- Error handling and graceful failure
+## ✨ Features
 
-### Search System
+- **File Operations**: Atomic file/directory operations with validation, resource monitoring, and error handling.
+- **Search System**: Full-text search with configurable context, advanced JsonLogic queries, glob patterns, and frontmatter field support.
+- **Property Management**: YAML frontmatter parsing, intelligent merging, automatic timestamps, and custom field support.
+- **Security & Performance**: API key authentication, rate limiting, SSL options, resource monitoring, and graceful shutdown.
 
-- Full-text search with configurable context
-- Advanced JsonLogic queries for files, tags, and metadata
-- Support for glob patterns and frontmatter fields
+## 🚀 Installation
 
-### Property Management
+Note: Requires Node.js and the [Local REST API plugin](https://github.com/coddingtonbear/obsidian-local-rest-api) enabled in Obsidian.
 
-- YAML frontmatter parsing and intelligent merging
-- Automatic timestamps (created by Obsidian, modified by server)
-- Custom field support
+### Option 1: Clone and Build (for development or direct use)
 
-### Security & Performance
+1.  Enable the Local REST API plugin in Obsidian.
+2.  Clone the repository, install dependencies, and build the project:
+    ```bash
+    git clone git@github.com:cyanheads/obsidian-mcp-server.git
+    cd obsidian-mcp-server
+    npm install
+    npm run build
+    ```
+3.  Configure the server using environment variables (see Configuration section below).
 
-- API key auth with rate limiting and SSL options
-- Resource monitoring and health checks
-- Graceful shutdown handling
+4.  Configure your MCP client settings (e.g., `claude_desktop_config.json` or `cline_mcp_settings.json`) to include the server. See the Configuration section for details.
 
-## Installation
+### Option 2: Install via npm (as a dependency or globally)
 
-Note: Requires Node.js
+1.  Enable the Local REST API plugin in Obsidian.
+2.  Install the package using npm:
 
-1. Enable Local REST API plugin in Obsidian
-2. Clone and build:
+    ```bash
+    # Install locally (e.g., within another project)
+    npm install obsidian-mcp-server
 
-```bash
-git clone git@github.com:cyanheads/obsidian-mcp-server.git
-cd obsidian-mcp-server
-npm install
-npm run build
-```
-
-Or install from npm:
+    # Or install globally
+    npm install -g obsidian-mcp-server
+    ```
 
-```bash
-npm install obsidian-mcp-server
-```
+3.  Configure your MCP client settings (e.g., `claude_desktop_config.json` or `cline_mcp_settings.json`) to include the server. See the Configuration section for details.
 
-## Configuration
+## ⚙️ Configuration
 
 Add to your MCP client settings (e.g., `claude_desktop_config.json` or `cline_mcp_settings.json`):
 
@@ -67,7 +67,7 @@ Add to your MCP client settings (e.g., `claude_desktop_config.json` or `cline_mc
   "mcpServers": {
     "obsidian-mcp-server": {
       "command": "node",
-      "args": ["/path/to/obsidian-mcp-server/build/index.js"],
+      "args": ["/path/to/obsidian-mcp-server/dist/index.js"],
       "env": {
         "OBSIDIAN_API_KEY": "your_api_key_here",
         "VERIFY_SSL": "false",
@@ -86,35 +86,42 @@ Add to your MCP client settings (e.g., `claude_desktop_config.json` or `cline_mc
 }
 ```
 
-Environment Variables:
-
-Required:
-
-- `OBSIDIAN_API_KEY`: Your API key from Obsidian's Local REST API plugin settings
-
-Connection Settings:
-
-- `VERIFY_SSL`: Enable SSL certificate verification (default: false) # This must be set to false for self-signed certificates. If you are running locally or don't understand what this means, this should be set to false.
-- `OBSIDIAN_PROTOCOL`: Protocol to use (default: "https")
-- `OBSIDIAN_HOST`: Host address (default: "127.0.0.1")
-- `OBSIDIAN_PORT`: Port number (default: 27124)
-
-Request Limits:
-
-- `REQUEST_TIMEOUT`: Request timeout in milliseconds (default: 5000)
-- `MAX_CONTENT_LENGTH`: Maximum response content length in bytes (default: 52428800 [50MB])
-- `MAX_BODY_LENGTH`: Maximum request body length in bytes (default: 52428800 [50MB])
-
-Rate Limiting:
-
-- `RATE_LIMIT_WINDOW_MS`: Rate limit window in milliseconds (default: 900000 [15 minutes])
-- `RATE_LIMIT_MAX_REQUESTS`: Maximum requests per window (default: 200)
-
-Tool Execution:
-
-- `TOOL_TIMEOUT_MS`: Tool execution timeout in milliseconds (default: 60000 [1 minute])
-
-## Project Structure
+**Environment Variables:**
+
+- `OBSIDIAN_API_KEY` (Required): Your API key from Obsidian's Local REST API plugin settings.
+- `VERIFY_SSL` (Default: `false`): Enable SSL verification. Set to `false` for self-signed certificates or local use.
+- `OBSIDIAN_PROTOCOL` (Default: `"https"`): Protocol (`http` or `https`).
+- `OBSIDIAN_HOST` (Default: `"127.0.0.1"`): Host address.
+- `OBSIDIAN_PORT` (Default: `27124`): Port number.
+- `REQUEST_TIMEOUT` (Default: `5000`): Request timeout (ms).
+- `MAX_CONTENT_LENGTH` (Default: `52428800` [50MB]): Max response content length (bytes).
+- `MAX_BODY_LENGTH` (Default: `52428800` [50MB]): Max request body length (bytes).
+- `RATE_LIMIT_WINDOW_MS` (Default: `900000` [15 min]): Rate limit window (ms).
+- `RATE_LIMIT_MAX_REQUESTS` (Default: `200`): Max requests per window.
+- `TOOL_TIMEOUT_MS` (Default: `60000` [1 min]): Tool execution timeout (ms).
+
+## 🛠️ Tools
+
+| Tool                             | Description                                                                                                                                                                                                                                                                                                                                   | Parameters                                                                                                                                                                                                                                                                                   |
+| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **obsidian_list_files_in_vault** | Lists all files and directories within the root of your Obsidian vault. Returns a hierarchical structure detailing files, folders, and their types.                                                                                                                                                                                           | None                                                                                                                                                                                                                                                                                         |
+| **obsidian_list_files_in_dir**   | Lists files and directories within a specific folder in your Obsidian vault. Returns a hierarchical structure. Note: Empty directories may not be included in the results. Useful for exploring vault organization.                                                                                                                           | `dirpath*`: Path to list files from (relative to vault root). Note that empty directories will not be returned.                                                                                                                                                                              |
+| **obsidian_get_file_contents**   | Retrieves the full content of a specified file within your Obsidian vault. Supports various readable file formats.                                                                                                                                                                                                                            | `filepath*`: Path to the relevant file (relative to your vault root).                                                                                                                                                                                                                        |
+| **obsidian_append_content**      | Appends the provided content to the end of a specified file in the vault. If the file does not exist, it will be created.                                                                                                                                                                                                                     | `filepath*`: Path to the file (relative to vault root)<br>`content*`: Content to append to the file                                                                                                                                                                                          |
+| **obsidian_update_content**      | Overwrites the entire content of a specified file in the vault with the provided content. If the file does not exist, it will be created.                                                                                                                                                                                                     | `filepath*`: Path to the file (relative to vault root)<br>`content*`: The new, complete content for the file (overwrites existing content).                                                                                                                                                  |
+| **obsidian_find_in_file**        | Performs a full-text search across all files in your Obsidian vault. Returns matching files with context around each match. If more than 5 files match, only filenames and match counts are returned to avoid excessive output. Ideal for locating specific text, tags, or patterns.                                                          | `query*`: Text pattern to search for. Can include tags, keywords, or phrases.<br>`contextLength`: Number of characters surrounding each match to provide context (default: 10).                                                                                                              |
+| **obsidian_complex_search**      | Finds files based on path patterns using JsonLogic queries. Primarily supports `glob` for pattern matching (e.g., '\*.md') and `var` for accessing the 'path' variable. Note: For content-based searches (full-text, tags within content, dates), use `obsidian_find_in_file`.                                                                | `query*`: A JsonLogic query object targeting file paths. Example: `{"glob": ["*.md", {"var": "path"}]}` matches all markdown files.                                                                                                                                                          |
+| **obsidian_get_tags**            | Retrieves all tags defined in the YAML frontmatter of markdown files within your Obsidian vault, along with their usage counts and associated file paths. Optionally, limit the search to a specific folder.                                                                                                                                  | `path`: Optional folder path (relative to vault root) to restrict the tag search.                                                                                                                                                                                                            |
+| **obsidian_get_properties**      | Retrieves properties (like title, tags, status) from the YAML frontmatter of a specified Obsidian note. Returns all defined properties, including any custom fields.                                                                                                                                                                          | `filepath*`: Path to the note file (relative to vault root)                                                                                                                                                                                                                                  |
+| **obsidian_update_properties**   | Updates properties within the YAML frontmatter of a specified Obsidian note. By default, array properties (like tags, type, status) are merged; use the 'replace' option to overwrite them instead. Handles custom fields and manages timestamps automatically. See schema for supported standard fields (title, author, tags, status, etc.). | `filepath*`: Path to the note file (relative to vault root)<br>`properties*`: Properties to update<br>`replace`: If true, array properties (like tags, status) will be completely replaced with the provided values instead of being merged with existing values. Defaults to false (merge). |
+
+## 🔗 Resources
+
+| Resource            | Description                                                             | Returns          |
+| ------------------- | ----------------------------------------------------------------------- | ---------------- |
+| **obsidian://tags** | List of all tags used across the Obsidian vault with their usage counts | application/json |
+
+## 📁 Project Structure
 
 The project follows a modular architecture with clear separation of concerns:
 
@@ -131,140 +138,7 @@ src/
   └── utils/            # Shared utilities
 ```
 
-## Tools
-
-### File Management
-
-```typescript
-// List vault contents
-obsidian_list_files_in_vault: {
-}
-
-// List directory contents
-obsidian_list_files_in_dir: {
-  dirpath: string; // Path relative to vault root
-}
-
-// Get file contents
-obsidian_get_file_contents: {
-  filepath: string; // Path relative to vault root
-}
-```
-
-### Search Operations
-
-```typescript
-// Text search with context
-obsidian_find_in_file: {
-  query: string,
-  contextLength?: number  // Default: 10
-}
-
-// Advanced search with JsonLogic
-obsidian_complex_search: {
-  query: JsonLogicQuery
-  // Examples:
-  // Find by tag:
-  // {"in": ["#mytag", {"var": "frontmatter.tags"}]}
-  //
-  // Find markdown files in a directory:
-  // {"glob": ["docs/*.md", {"var": "path"}]}
-  //
-  // Combine conditions:
-  // {"and": [
-  //   {"glob": ["*.md", {"var": "path"}]},
-  //   {"in": ["#mytag", {"var": "frontmatter.tags"}]}
-  // ]}
-}
-
-// Get all tags in vault or directory
-obsidian_get_tags: {
-  path?: string  // Optional: limit to specific directory
-}
-```
-
-### Content Modification
-
-```typescript
-// Append to file
-obsidian_append_content: {
-  filepath: string,  // Path relative to vault root
-  content: string    // Content to append
-}
-
-// Update file content
-obsidian_patch_content: {
-  filepath: string,  // Path relative to vault root
-  content: string    // New content (replaces existing)
-}
-```
-
-### Property Management
-
-```typescript
-// Get note properties
-obsidian_get_properties: {
-  filepath: string  // Path relative to vault root
-}
-
-// Update note properties
-obsidian_update_properties: {
-  filepath: string,  // Path relative to vault root
-  properties: {
-    title?: string,
-    author?: string,
-    // Note: created/modified timestamps are managed automatically
-    type?: Array<"concept" | "architecture" | "specification" |
-      "protocol" | "api" | "research" | "implementation" |
-      "guide" | "reference">,
-    tags?: string[],  // Must start with #
-    status?: Array<"draft" | "in-progress" | "review" | "complete">,
-    version?: string,
-    platform?: string,
-    repository?: string,  // URL
-    dependencies?: string[],
-    sources?: string[],
-    urls?: string[],      // URLs
-    papers?: string[],
-    custom?: Record<string, unknown>
-  }
-}
-```
-
-## Best Practices
-
-### File Operations
-
-- Use atomic operations with validation
-- Handle errors and monitor performance
-
-### Search Implementation
-
-- Use appropriate search tool for the task:
-  - obsidian_find_in_file for text search
-  - obsidian_complex_search for metadata/tag filtering
-- Keep context size reasonable (default: 10 chars)
-
-### Property Management
-
-- Use appropriate types and validate updates
-- Handle arrays and custom fields properly
-- Never set timestamps (managed automatically)
-
-### Error Prevention
-
-- Validate inputs and handle errors gracefully
-- Monitor patterns and respect rate limits
-
-## Resources
-
-The MCP server exposes the following resources:
-
-```
-obsidian://tags  # List of all tags used across the vault
-```
-
-## Contributing
+## 👥 Contributing
 
 1. Fork the repository
 2. Create a feature branch
@@ -272,19 +146,9 @@ obsidian://tags  # List of all tags used across the vault
 
 For bugs and features, create an issue at [https://github.com/cyanheads/obsidian-mcp-server/issues](https://github.com/cyanheads/obsidian-mcp-server/issues).
 
-## Publishing
-
-The package is automatically published to npm when version tags are pushed:
-
-```bash
-# Update version in package.json
-npm version patch  # or minor, or major
-git push --follow-tags
-```
-
-This will trigger the GitHub Action to build and publish the package.
+## 📄 License
 
-## License
+[![Apache 2.0 License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 Apache License 2.0
 

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export { run } from "./mcp/server.js";
+export * from "./obsidian/index.js";
+export * from "./resources/index.js";
+export * from "./tools/index.js";
+export * from "./utils/index.js";

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,2CAA2C;AAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpC,mBAAmB;AACnB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC5C,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACpB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sDAAsD;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/mcp/handlers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MCP server request handlers
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { BaseToolHandler } from "../tools/base.js";
+/**
+ * Set up tool listing handler
+ * @param server The MCP server instance
+ * @param toolHandlers The tool handlers to register
+ */
+export declare function setupToolListingHandler(server: Server, toolHandlers: Map<string, BaseToolHandler<any>>): void;
+/**
+ * Set up tool calling handler
+ * @param server The MCP server instance
+ * @param toolHandlers The tool handlers to register
+ */
+export declare function setupToolCallingHandler(server: Server, toolHandlers: Map<string, BaseToolHandler<any>>): void;
+/**
+ * Set up resource listing handler
+ * @param server The MCP server instance
+ * @param resources The resources to register
+ */
+export declare function setupResourceListingHandler(server: Server, resources: Record<string, any>): void;
+/**
+ * Set up resource reading handler
+ * @param server The MCP server instance
+ * @param resources The resources to register
+ */
+export declare function setupResourceReadingHandler(server: Server, resources: Record<string, any>): void;

package/dist/mcp/handlers.js.map

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

package/{src/mcp/index.ts → dist/mcp/index.d.ts}

@@ -4,4 +4,3 @@
 export * from './handlers.js';
 export * from './server.js';
 export * from './types.js';
-

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP server implementation
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Initialize MCP server components
+ */
+export declare function initializeServer(): Promise<Server>;
+/**
+ * Set up graceful shutdown handling
+ * @param server The MCP server instance
+ * @param cleanupHandlers Additional cleanup handlers to run on shutdown
+ */
+export declare function setupShutdownHandling(server: Server, cleanupHandlers?: (() => Promise<void> | void)[]): void;
+/**
+ * Run the MCP server
+ */
+export declare function run(): Promise<void>;

package/dist/mcp/server.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * MCP server type definitions
+ */
+import { TextContent, Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ErrorCategoryType, StandardizedErrorObject } from "../utils/logging.js";
+/**
+ * MCP server configuration
+ */
+export interface McpServerConfig extends Record<string, unknown> {
+    name: string;
+    version: string;
+}
+/**
+ * Timeout configuration for tool execution
+ */
+export interface TimeoutConfig {
+    toolExecutionMs: number;
+}
+/**
+ * Map of resources by URI
+ */
+export interface ResourceMap {
+    [uri: string]: {
+        getContent(): Promise<TextContent[]>;
+        getResourceDescription(): any;
+    };
+}
+/**
+ * Server capabilities configuration
+ */
+export interface ServerCapabilities {
+    tools: Record<string, Tool>;
+    resources: ResourceMap;
+}
+/**
+ * Operation result interface following MCP best practices
+ */
+export interface OperationResultSuccess<DataType> {
+    resultSuccessful: true;
+    resultData: DataType;
+}
+export interface OperationResultFailure {
+    resultSuccessful: false;
+    resultError: StandardizedErrorObject;
+}
+export type OperationResult<DataType> = OperationResultSuccess<DataType> | OperationResultFailure;
+/**
+ * Error codes used in the MCP server
+ */
+export declare enum McpErrorCode {
+    INTERNAL_SERVER_ERROR = 50000,
+    SERVICE_UNAVAILABLE = 50300,
+    TIMEOUT = 50800,
+    BAD_REQUEST = 40000,
+    UNAUTHORIZED = 40100,
+    FORBIDDEN = 40300,
+    NOT_FOUND = 40400,
+    METHOD_NOT_ALLOWED = 40500,
+    RATE_LIMIT_EXCEEDED = 40900,
+    SUCCESS_NO_CONTENT = 20400
+}
+/**
+ * Default timeout configuration
+ */
+export declare const DEFAULT_TIMEOUT_CONFIG: TimeoutConfig;
+/**
+ * Helper functions for creating operation results
+ */
+export declare function createSuccessResult<DataType>(data: DataType): OperationResultSuccess<DataType>;
+export declare function createFailureResult(message: string, code: string | McpErrorCode, category?: ErrorCategoryType, context?: Record<string, unknown>): OperationResultFailure;

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAA2B,MAAM,qBAAqB,CAAC;AAoD3F;;GAEG;AACH,MAAM,CAAN,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,wBAAwB;IACxB,qFAA6B,CAAA;IAC7B,iFAA2B,CAAA;IAC3B,yDAAe,CAAA;IAEf,wBAAwB;IACxB,iEAAmB,CAAA;IACnB,mEAAoB,CAAA;IACpB,6DAAiB,CAAA;IACjB,6DAAiB,CAAA;IACjB,+EAA0B,CAAA;IAC1B,iFAA2B,CAAA;IAE3B,gCAAgC;IAChC,+EAA0B,CAAA;AAC5B,CAAC,EAhBW,YAAY,KAAZ,YAAY,QAgBvB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,eAAe,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC,4BAA4B;CAC/F,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAW,IAAc;IAC1D,OAAO;QACL,gBAAgB,EAAE,IAAI;QACtB,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,IAA2B,EAC3B,WAA8B,iBAAiB,CAAC,gBAAgB,EAChE,OAAiC;IAEjC,OAAO;QACL,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE;YACX,YAAY,EAAE,OAAO;YACrB,SAAS,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;YACzD,aAAa,EAAE,QAAQ;YACvB,aAAa,EAAE,QAAQ,CAAC,KAAK;YAC7B,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACxC,YAAY,EAAE,OAAO;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/obsidian/client.d.ts

@@ -0,0 +1,109 @@
+import { JsonLogicQuery, NoteJson, ObsidianCommand, ObsidianConfig, ObsidianFile, ObsidianStatus, PeriodType, SearchResponse, SimpleSearchResult } from './types.js';
+/**
+ * Client for interacting with the Obsidian Local REST API
+ */
+export declare class ObsidianClient {
+    private client;
+    private config;
+    /**
+     * Create a new ObsidianClient
+     * @param config Configuration for the client
+     */
+    constructor(config: ObsidianConfig);
+    /**
+     * Get the base URL for the Obsidian API
+     */
+    private getBaseUrl;
+    /**
+     * Get headers for requests to the Obsidian API
+     */
+    private getHeaders;
+    /**
+     * Safely execute an API request with error handling
+     */
+    private safeRequest;
+    /**
+     * List all files in the vault
+     */
+    listFilesInVault(): Promise<ObsidianFile[]>;
+    /**
+     * List files in a specific directory
+     */
+    listFilesInDir(dirpath: string): Promise<ObsidianFile[]>;
+    /**
+     * Get the contents of a file
+     */
+    getFileContents(filepath: string): Promise<string>;
+    /**
+     * Search for a string across all files
+     */
+    search(query: string, contextLength?: number): Promise<SimpleSearchResult[]>;
+    /**
+     * Append content to a file
+     */
+    appendContent(filepath: string, content: string): Promise<void>;
+    /**
+     * Update the entire content of a file
+     */
+    updateContent(filepath: string, content: string): Promise<void>;
+    /**
+     * Execute a complex search using JsonLogic query
+     */
+    searchJson(query: JsonLogicQuery): Promise<SearchResponse[]>;
+    /**
+     * Get server status
+     */
+    getStatus(): Promise<ObsidianStatus>;
+    /**
+     * List available commands
+     */
+    listCommands(): Promise<ObsidianCommand[]>;
+    /**
+     * Execute a command by ID
+     */
+    executeCommand(commandId: string): Promise<void>;
+    /**
+     * Open a file in Obsidian
+     */
+    openFile(filepath: string, newLeaf?: boolean): Promise<void>;
+    /**
+     * Get the currently active file
+     */
+    getActiveFile(): Promise<NoteJson>;
+    /**
+     * Update the active file
+     */
+    updateActiveFile(content: string): Promise<void>;
+    /**
+     * Delete the active file
+     */
+    deleteActiveFile(): Promise<void>;
+    /**
+     * Patch the active file
+     */
+    patchActiveFile(operation: "append" | "prepend" | "replace", targetType: "heading" | "block" | "frontmatter", target: string, content: string, options?: {
+        delimiter?: string;
+        trimWhitespace?: boolean;
+        contentType?: "text/markdown" | "application/json";
+    }): Promise<void>;
+    /**
+     * Get a periodic note (e.g., daily, weekly)
+     */
+    getPeriodicNote(period: PeriodType["type"]): Promise<NoteJson>;
+    /**
+     * Update a periodic note
+     */
+    updatePeriodicNote(period: PeriodType["type"], content: string): Promise<void>;
+    /**
+     * Delete a periodic note
+     */
+    deletePeriodicNote(period: PeriodType["type"]): Promise<void>;
+    /**
+     * Patch a periodic note
+     */
+    patchPeriodicNote(period: PeriodType["type"], operation: "append" | "prepend" | "replace", targetType: "heading" | "block" | "frontmatter", target: string, content: string, options?: {
+        delimiter?: string;
+        trimWhitespace?: boolean;
+        contentType?: "text/markdown" | "application/json";
+    }): Promise<void>;
+}