obsidian-mcp-server 2.0.7 → 3.1.0

package/dist/services/obsidian/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Shared types for the Obsidian Local REST API service layer.
+ * Mirrors the upstream plugin's response shapes (NoteJson, document map, etc.).
+ * @module services/obsidian/types
+ */
+export type PeriodicPeriod = 'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly';
+export type NoteTarget = {
+    type: 'path';
+    path: string;
+} | {
+    type: 'active';
+} | {
+    type: 'periodic';
+    period: PeriodicPeriod;
+    date?: string | undefined;
+};
+export type SectionType = 'heading' | 'block' | 'frontmatter';
+export interface SectionTarget {
+    /** Heading name ("::" delimits nesting), block reference, or frontmatter field name. */
+    target: string;
+    type: SectionType;
+}
+export interface NoteStat {
+    ctime: number;
+    mtime: number;
+    size: number;
+}
+export interface NoteJson {
+    content: string;
+    frontmatter: Record<string, unknown>;
+    path: string;
+    stat: NoteStat;
+    tags: string[];
+}
+export interface DocumentMap {
+    blocks: string[];
+    frontmatterFields: string[];
+    headings: string[];
+}
+export interface FileListing {
+    files: string[];
+}
+export interface VaultStatus {
+    authenticated: boolean;
+    manifest?: {
+        id: string;
+        name: string;
+        version: string;
+    };
+    service: string;
+    status: string;
+    versions?: {
+        obsidian?: string;
+        self?: string;
+    };
+}
+export interface ObsidianTag {
+    count: number;
+    name: string;
+}
+export interface ObsidianCommand {
+    id: string;
+    name: string;
+}
+export type SearchMode = 'text' | 'dataview' | 'jsonlogic';
+export interface TextSearchHit {
+    filename: string;
+    matches: Array<{
+        context: string;
+        match: {
+            start: number;
+            end: number;
+        };
+    }>;
+    score?: number;
+}
+export interface StructuredSearchHit {
+    filename: string;
+    result: unknown;
+}
+export interface PatchHeaders {
+    applyIfContentPreexists?: boolean | undefined;
+    contentType?: 'markdown' | 'json' | undefined;
+    createTargetIfMissing?: boolean | undefined;
+    operation: 'append' | 'prepend' | 'replace';
+    target: string;
+    targetDelimiter?: string | undefined;
+    targetType: SectionType;
+    trimTargetWhitespace?: boolean | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/obsidian/types.d.ts.map

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

package/dist/services/obsidian/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Shared types for the Obsidian Local REST API service layer.
+ * Mirrors the upstream plugin's response shapes (NoteJson, document map, etc.).
+ * @module services/obsidian/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/obsidian/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/obsidian/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,91 +1,85 @@
 {
   "name": "obsidian-mcp-server",
-  "version": "2.0.7",
-  "description": "Obsidian Knowledge-Management MCP (Model Context Protocol) server that enables AI agents and development tools to interact with an Obsidian vault. It provides a comprehensive suite of tools for reading, writing, searching, and managing notes, tags, and frontmatter, acting as a bridge to the Obsidian Local REST API plugin.",
+  "version": "3.1.0",
+  "mcpName": "io.github.cyanheads/obsidian-mcp-server",
+  "description": "MCP server for Obsidian vaults — read, write, search, and surgically edit notes, tags, and frontmatter via the Local REST API plugin. STDIO or Streamable HTTP.",
+  "type": "module",
   "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "obsidian-mcp-server": "dist/index.js"
+  },
   "files": [
-    "dist",
+    "changelog/",
+    "dist/",
     "README.md",
     "LICENSE",
-    "CHANGELOG.md"
+    "CLAUDE.md",
+    "Dockerfile",
+    "server.json"
   ],
-  "bin": {
-    "obsidian-mcp-server": "dist/index.js"
-  },
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cyanheads/obsidian-mcp-server.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cyanheads/obsidian-mcp-server/issues"
-  },
-  "homepage": "https://github.com/cyanheads/obsidian-mcp-server#readme",
   "scripts": {
-    "build": "tsc && node --loader ts-node/esm scripts/make-executable.ts dist/index.js",
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "tree": "bun run scripts/tree.ts",
+    "format": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "test": "bunx vitest run",
+    "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
+    "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
     "start": "node dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio node dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http node dist/index.js",
-    "rebuild": "npx ts-node --esm scripts/clean.ts && npm run build",
-    "fetch:spec": "npx ts-node --esm scripts/fetch-openapi-spec.ts",
-    "docs:generate": "typedoc --tsconfig ./tsconfig.typedoc.json",
-    "tree": "npx ts-node --esm scripts/tree.ts",
-    "format": "prettier --write \"**/*.{ts,js,json,md,html,css}\"",
-    "inspect": "mcp-inspector --config mcp.json",
-    "inspect:stdio": "mcp-inspector --config mcp.json --server obsidian-mcp-server-stdio",
-    "inspect:http": "mcp-inspector --config mcp.json --server obsidian-mcp-server-http"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.14.4",
-    "@modelcontextprotocol/inspector": "^0.14.3",
-    "@modelcontextprotocol/sdk": "^1.13.0",
-    "@types/sanitize-html": "^2.16.0",
-    "@types/validator": "13.15.2",
-    "axios": "^1.10.0",
-    "chrono-node": "2.8.0",
-    "date-fns": "^4.1.0",
-    "dotenv": "^16.5.0",
-    "hono": "^4.8.2",
-    "ignore": "^7.0.5",
-    "jose": "^6.0.11",
-    "js-yaml": "^4.1.0",
-    "openai": "^5.6.0",
-    "partial-json": "^0.1.7",
-    "sanitize-html": "^2.17.0",
-    "tiktoken": "^1.0.21",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "validator": "13.15.15",
-    "winston": "^3.17.0",
-    "winston-transport": "^4.9.0",
-    "zod": "^3.25.67"
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
   },
   "keywords": [
     "mcp",
+    "mcp-server",
     "model-context-protocol",
     "obsidian",
-    "obsidian-md",
-    "ai",
-    "llm",
-    "agent",
-    "automation",
-    "api",
-    "server",
-    "typescript",
-    "knowledge-management",
+    "obsidian-vault",
+    "knowledge-base",
     "note-taking",
-    "rest-api",
-    "integration"
+    "llm",
+    "llm-agent",
+    "ai-tools",
+    "typescript"
   ],
-  "author": "Casey Hand @cyanheads",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/obsidian-mcp-server#readme)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/obsidian-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/obsidian-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/obsidian-mcp-server/issues"
+  },
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=16.0.0"
+    "bun": ">=1.3.11",
+    "node": ">=22.0.0"
   },
-  "devDependencies": {
+  "packageManager": "bun@1.3.11",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.8.2",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.3",
-    "prettier": "^3.5.3",
-    "typedoc": "^0.28.5"
+    "js-yaml": "^4.1.1",
+    "pino-pretty": "^13.1.3",
+    "undici": "^8.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.13",
+    "@types/node": "^25.6.0",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   }
 }

package/server.json

@@ -0,0 +1,167 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/obsidian-mcp-server",
+  "description": "MCP server for Obsidian vaults — read, write, search, and edit notes via the Local REST API plugin.",
+  "repository": {
+    "url": "https://github.com/cyanheads/obsidian-mcp-server",
+    "source": "github"
+  },
+  "version": "3.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "obsidian-mcp-server",
+      "runtimeHint": "node",
+      "version": "3.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:stdio"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "OBSIDIAN_API_KEY",
+          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).",
+          "format": "string",
+          "isRequired": true
+        },
+        {
+          "name": "OBSIDIAN_BASE_URL",
+          "description": "Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable \"Non-encrypted (HTTP) Server\" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://127.0.0.1:27123"
+        },
+        {
+          "name": "OBSIDIAN_VERIFY_SSL",
+          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
+          "description": "Per-request timeout in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "30000"
+        },
+        {
+          "name": "OBSIDIAN_ENABLE_COMMANDS",
+          "description": "Opt-in flag for the command-palette pair (obsidian_list_commands + obsidian_execute_command). Off by default — Obsidian commands are opaque and can be destructive.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "obsidian-mcp-server",
+      "runtimeHint": "node",
+      "version": "3.1.0",
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "run"
+        },
+        {
+          "type": "positional",
+          "value": "start:http"
+        }
+      ],
+      "environmentVariables": [
+        {
+          "name": "OBSIDIAN_API_KEY",
+          "description": "Bearer token for the Obsidian Local REST API plugin (Settings → Community Plugins → Local REST API).",
+          "format": "string",
+          "isRequired": true
+        },
+        {
+          "name": "OBSIDIAN_BASE_URL",
+          "description": "Base URL of the Obsidian Local REST API. Default: http://127.0.0.1:27123 (enable \"Non-encrypted (HTTP) Server\" in plugin settings). Use https://127.0.0.1:27124 for the always-on HTTPS port (self-signed cert; pair with OBSIDIAN_VERIFY_SSL=false).",
+          "format": "string",
+          "isRequired": false,
+          "default": "http://127.0.0.1:27123"
+        },
+        {
+          "name": "OBSIDIAN_VERIFY_SSL",
+          "description": "Whether to verify the TLS certificate on the Obsidian endpoint. Default false because the plugin uses a self-signed cert.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "OBSIDIAN_REQUEST_TIMEOUT_MS",
+          "description": "Per-request timeout in milliseconds.",
+          "format": "string",
+          "isRequired": false,
+          "default": "30000"
+        },
+        {
+          "name": "OBSIDIAN_ENABLE_COMMANDS",
+          "description": "Opt-in flag for the command-palette pair (obsidian_list_commands + obsidian_execute_command). Off by default — Obsidian commands are opaque and can be destructive.",
+          "format": "string",
+          "isRequired": false,
+          "default": "false"
+        },
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}

package/CHANGELOG.md

@@ -1,124 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [2.0.7] - 2025-06-20
-
-### Changed
-
-- **Package Update**: Fixed README & incremented version to 2.0.7 to ensure the latest changes are reflected in the npm package.
-
-## [2.0.6] - 2025-06-20
-
-### Changed
-
-- **Tool Renaming**: Renamed `obsidian_read_file`, `obsidian_delete_file`, and `obsidian_list_files` to `obsidian_read_note`, `obsidian_delete_note`, and `obsidian_list_notes` respectively. This change improves semantic clarity and aligns the tool names more closely with Obsidian's terminology, reducing ambiguity for AI agents.
-- **Dependency Updates**: Updated all dependencies to their latest versions.
-- **Documentation Improvements**: Updated `.clinerules` to reflect the new tool names and ensure all documentation is current.
-
-## [2.0.5] - 2025-06-20
-
-### Changed
-
-- **Tool Renaming**: Renamed the `obsidian_update_file` tool to `obsidian_update_note` to avoid conflicts and better reflect its function. During agentic use, LLMs confused this tool with filesystem operations, leading to errors. The new name clarifies that it operates on Obsidian notes specifically.
-- **HTTP Transport Refactor**: Restructured the HTTP transport layer for improved clarity and robustness. Authentication logic is now more modular, and a centralized error handler has been implemented.
-- **Dependency Updates**: Updated all dependencies to their latest versions.
-- **Documentation Improvements**: Enhanced the documentation around installation & MCP Client configuration. Suggested by [@bgheneti](https://github.com/bgheneti) in [PR #14](https://github.com/cyanheads/obsidian-mcp-server/pull/14). Thanks!
-
-## [2.0.4] - 2025-06-13
-
-### Added
-
-- **Recursive File Listing**: The `obsidian_list_files` tool now supports recursive listing of directories with a `recursionDepth` parameter.
-
-### Changed
-
-- **Documentation**:
-  - Consolidated tool specifications into `obsidian_mcp_tools_spec.md`.
-  - Updated `.clinerules` with a detailed logger implementation example for the agent.
-  - Updated the repository's directory tree documentation.
-
-## [2.0.3] - 2025-06-12
-
-### Fixed
-
-- **NPM Package Display**: Explicitly included `README.md`, `LICENSE`, and `CHANGELOG.md` in the `files` array in `package.json` to ensure they are displayed correctly on the npm package page.
-
-## [2.0.2] - 2025-06-12
-
-### Fixed
-
-- **NPM Package Version**: Bad npm package. Bumping to v2.0.2 for publishing.
-
-## [2.0.1] - 2025-06-12
-
-### Added
-
-- **Enhanced Documentation**:
-  - Added a warning to the `VaultCacheService` documentation about its potential for high memory usage on large vaults.
-  - Added a code comment in `obsidianManageFrontmatterTool` to clarify the regex-based key deletion strategy.
-
-### Changed
-
-- **Improved SSL Handling**: The `OBSIDIAN_VERIFY_SSL` environment variable is now correctly parsed as a boolean, ensuring more reliable SSL verification behavior.
-- **API Service Refactoring**: Simplified the `httpsAgent` handling within the `ObsidianRestApiService` to improve code clarity and remove redundant agent creation on each request.
-
-### Fixed
-
-- **Path Import Correction**: Corrected a path import in the `obsidianGlobalSearchTool` to use `node:path/posix` for better cross-platform compatibility.
-
-## [2.0.0] - 2025-06-12
-
-Version 2.0.0 is a complete overhaul of the Obsidian MCP Server, migrating it to my [`cyanheads/mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template). This release introduces a more robust architecture, a streamlined toolset, enhanced security, and significant performance improvements. It is a breaking change from the 1.x series.
-
-### Added
-
-- **New Core Architecture**: The server is now built on the [`cyanheads/mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template), providing a standardized, modular, and maintainable structure.
-- **Hono HTTP Transport**: The HTTP transport has been migrated from Express to Hono, offering a more lightweight and performant server.
-- **Vault Cache Service**: A new in-memory `VaultCacheService` has been introduced. It caches vault content to improve performance for search operations and provides a resilient fallback if the Obsidian API is temporarily unavailable. It also refreshes periodically.
-- **Advanced Authentication**:
-  - Added support for **OAuth 2.1** bearer token validation alongside the existing secret key-based JWTs.
-  - Introduced `authContext` using `AsyncLocalStorage` for secure, request-scoped access to authentication details.
-- **New Tools**:
-  - `obsidian_delete_file`: A new tool to permanently delete files from the vault.
-  - `obsidian_search_replace`: A powerful new tool to perform search and replace operations with regex support.
-- **Enhanced Utilities**:
-  - **Request Context**: A robust request context system (`requestContextService`) for improved logging and tracing.
-  - **Error Handling**: A centralized `ErrorHandler` for consistent and detailed error reporting.
-  - **Async Utilities**: A `retryWithDelay` utility is now used across the application to make API calls more resilient.
-- **New Development Scripts**: Added `docs:generate` (for TypeDoc) and `inspect:stdio`/`inspect:http` (for MCP Inspector) to `package.json`.
-
-### Changed
-
-- **Project Structure**: The entire project has been reorganized to align with the [`cyanheads/mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template), improving separation of concerns (e.g., `services`, `mcp-server`, `types-global`).
-- **Tool Consolidation and Enhancement**: The toolset has been redesigned for clarity and power:
-  - `obsidian_list_files` replaces `obsidian_list_files_in_vault` and `obsidian_list_files_in_dir`, offering more flexible filtering.
-  - `obsidian_read_file` replaces `obsidian_get_file_contents` and now supports returning content as structured JSON.
-  - `obsidian_update_file` replaces `obsidian_append_content` and `obsidian_update_content` with explicit modes (`append`, `prepend`, `overwrite`).
-  - `obsidian_global_search` replaces `obsidian_find_in_file` with added support for path/date filtering and pagination.
-  - `obsidian_manage_frontmatter` replaces `obsidian_get_properties` and `obsidian_update_properties` with atomic get/set/delete operations.
-  - `obsidian_manage_tags` replaces `obsidian_get_tags` and now manages both frontmatter and inline tags.
-- **Configuration Overhaul**: Environment variables have been renamed for consistency and clarity.
-  - `OBSIDIAN_BASE_URL` now consolidates protocol, host, and port.
-  - New variables like `MCP_TRANSPORT_TYPE`, `MCP_LOG_LEVEL`, and `MCP_AUTH_SECRET_KEY` have been introduced.
-- **Dependency Updates**: All dependencies, including the MCP SDK, have been updated to their latest stable versions.
-- **Obsidian API Service**: The `ObsidianRestApiService` has been completely refactored into a modular class, providing a typed, resilient, and centralized client for all interactions with the Obsidian Local REST API.
-
-### Removed
-
-- **Removed Tools**: The following tools from version 1.x have been removed and their functionality integrated into the new, more comprehensive tools:
-  - `obsidian_list_files_in_vault`
-  - `obsidian_list_files_in_dir`
-  - `obsidian_get_file_contents`
-  - `obsidian_append_content`
-  - `obsidian_update_content`
-  - `obsidian_find_in_file`
-  - `obsidian_complex_search` (path-based searching is now a filter in `obsidian_global_search`)
-  - `obsidian_get_tags`
-  - `obsidian_get_properties`
-  - `obsidian_update_properties`
-- **Removed Resources**: The `obsidian://tags` resource has been removed. Tag information is now available through the `obsidian_manage_tags` tool. I may add the resource back in the future if there is demand for it. Please open an issue if you would like to see it return.
-- **Old Configuration**: All old, non-prefixed environment variables (e.g., `VERIFY_SSL`, `REQUEST_TIMEOUT`) have been removed in favor of the new, standardized configuration schema.

package/dist/config/index.d.ts

@@ -1,41 +0,0 @@
-/**
- * Main application configuration object.
- */
-export declare const config: {
-    pkg: {
-        name: string;
-        version: string;
-    };
-    mcpServerName: string;
-    mcpServerVersion: string;
-    logLevel: string;
-    logsPath: string;
-    environment: string;
-    mcpTransportType: "stdio" | "http";
-    mcpHttpPort: number;
-    mcpHttpHost: string;
-    mcpAllowedOrigins: string[] | undefined;
-    mcpAuthMode: "jwt" | "oauth" | undefined;
-    mcpAuthSecretKey: string | undefined;
-    oauthIssuerUrl: string | undefined;
-    oauthAudience: string | undefined;
-    oauthJwksUri: string | undefined;
-    obsidianApiKey: string;
-    obsidianBaseUrl: string;
-    obsidianVerifySsl: boolean;
-    obsidianCacheRefreshIntervalMin: number;
-    obsidianEnableCache: boolean;
-    obsidianApiSearchTimeoutMs: number;
-};
-/**
- * The configured logging level for the application.
- * Exported separately for convenience (e.g., logger initialization).
- * @type {string}
- */
-export declare const logLevel: string;
-/**
- * The configured runtime environment for the application.
- * Exported separately for convenience.
- * @type {string}
- */
-export declare const environment: string;