@sunub/obsidian-mcp-server 0.2.0 → 0.3.0

package/build/cli/hooks/useRagContext.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolFn } from "../types.js";
+export interface UseRagContextReturn {
+    fetchContext: (query: string) => Promise<string | null>;
+    isFetching: boolean;
+}
+export declare const useRagContext: (callTool: CallToolFn, isConnected: boolean) => UseRagContextReturn;

package/build/cli/hooks/useRagContext.js

@@ -0,0 +1,83 @@
+import { useCallback, useState } from "react";
+import { debugLogger } from "../utils/debugLogger.js";
+const MAX_CONTEXT_CHARS = 4000;
+const ANSI_RE = 
+// biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequences intentionally matched
+/[\u001b\u009b][[()#;?]*(?:\d{1,4}(?:;\d{0,4})*)?[A-Za-z0-9=><~]/g;
+function stripAnsi(text) {
+    return text.replace(ANSI_RE, "");
+}
+function extractTextFromResult(result) {
+    return result.content
+        .filter((c) => c.type === "text" && c.text)
+        .map((c) => c.text ?? "")
+        .join("\n");
+}
+function hasValidResults(result) {
+    if (result.isError) {
+        return false;
+    }
+    const text = extractTextFromResult(result);
+    return text.length > 0 && !text.includes("No results found");
+}
+function formatAsContext(rawText) {
+    const truncated = rawText.length > MAX_CONTEXT_CHARS
+        ? `${rawText.slice(0, MAX_CONTEXT_CHARS)}\n... (결과가 잘렸습니다)`
+        : rawText;
+    return [
+        "[Vault Context]",
+        "아래는 사용자의 Obsidian Vault에서 찾은 관련 문서입니다. 이 컨텍스트를 참고하여 답변해주세요.",
+        "",
+        truncated,
+        "",
+        "[End Vault Context]",
+    ].join("\n");
+}
+export const useRagContext = (callTool, isConnected) => {
+    const [isFetching, setIsFetching] = useState(false);
+    const fetchContext = useCallback(async (rawQuery) => {
+        if (!isConnected) {
+            debugLogger.debug("[RAG] MCP not connected, skipping context fetch.");
+            return null;
+        }
+        const query = stripAnsi(rawQuery).trim();
+        setIsFetching(true);
+        debugLogger.debug(`[RAG] Fetching context for: "${query}"`);
+        try {
+            const semanticResult = await callTool("vault", {
+                action: "search_vault_by_semantic",
+                query,
+                limit: 5,
+            });
+            if (hasValidResults(semanticResult)) {
+                const text = extractTextFromResult(semanticResult);
+                debugLogger.debug(`[RAG] Semantic search returned ${text.length} chars.`);
+                return formatAsContext(text);
+            }
+            debugLogger.debug("[RAG] Semantic search empty, falling back to keyword search.");
+            const keywordResult = await callTool("vault", {
+                action: "search",
+                keyword: query,
+                limit: 5,
+                includeContent: true,
+                compressionMode: "balanced",
+            });
+            if (hasValidResults(keywordResult)) {
+                const text = extractTextFromResult(keywordResult);
+                debugLogger.debug(`[RAG] Keyword search returned ${text.length} chars.`);
+                return formatAsContext(text);
+            }
+            debugLogger.debug("[RAG] No relevant context found in Vault.");
+            return null;
+        }
+        catch (err) {
+            debugLogger.error("[RAG] Context fetch failed:", err);
+            return null;
+        }
+        finally {
+            setIsFetching(false);
+        }
+    }, [callTool, isConnected]);
+    return { fetchContext, isFetching };
+};
+//# sourceMappingURL=useRagContext.js.map

package/build/cli/hooks/useRagContext.js.map

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

package/build/cli/hooks/useShellCompletion.d.ts

@@ -0,0 +1,18 @@
+import type React from "react";
+import type { Suggestion } from "../ui/SuggestionsDisplay.js";
+export interface UseShellCompletionOptions {
+    enabled: boolean;
+    line: string;
+    cursorCol: number;
+    cwd: string;
+    setSuggestions: React.Dispatch<React.SetStateAction<Suggestion[]>>;
+    setIsLoadingSuggestions: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface ShellCompletionRange {
+    query: string | null;
+    completionStart: number;
+    completionEnd: number;
+    activeStart: number;
+}
+/** Stub: Shell path/command completion. */
+export declare function useShellCompletion(_options: UseShellCompletionOptions): ShellCompletionRange;

package/build/cli/hooks/useShellCompletion.js

@@ -0,0 +1,10 @@
+/** Stub: Shell path/command completion. */
+export function useShellCompletion(_options) {
+    return {
+        query: null,
+        completionStart: -1,
+        completionEnd: -1,
+        activeStart: -1,
+    };
+}
+//# sourceMappingURL=useShellCompletion.js.map

package/build/cli/hooks/useShellCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShellCompletion.js","sourceRoot":"","sources":["../../../src/cli/hooks/useShellCompletion.ts"],"names":[],"mappings":"AAmBA,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CACjC,QAAmC;IAEnC,OAAO;QACN,KAAK,EAAE,IAAI;QACX,eAAe,EAAE,CAAC,CAAC;QACnB,aAAa,EAAE,CAAC,CAAC;QACjB,WAAW,EAAE,CAAC,CAAC;KACf,CAAC;AACH,CAAC"}

package/build/cli/hooks/useSlashCompletion.d.ts

@@ -0,0 +1,21 @@
+import type React from "react";
+import type { CommandContext, SlashCommand } from "../commands/types.js";
+import type { Suggestion } from "../ui/SuggestionsDisplay.js";
+export interface UseSlashCompletionOptions {
+    enabled: boolean;
+    query: string | null;
+    slashCommands: readonly SlashCommand[];
+    commandContext: CommandContext;
+    setSuggestions: React.Dispatch<React.SetStateAction<Suggestion[]>>;
+    setIsLoadingSuggestions: React.Dispatch<React.SetStateAction<boolean>>;
+    setIsPerfectMatch: React.Dispatch<React.SetStateAction<boolean>>;
+}
+export interface SlashCompletionRange {
+    completionStart: number;
+    completionEnd: number;
+    getCommandFromSuggestion: (suggestion: Suggestion) => SlashCommand | undefined;
+    isArgumentCompletion: boolean;
+    leafCommand: SlashCommand | null;
+}
+/** Stub: Slash-command completion. */
+export declare function useSlashCompletion(_options: UseSlashCompletionOptions): SlashCompletionRange;

package/build/cli/hooks/useSlashCompletion.js

@@ -0,0 +1,11 @@
+/** Stub: Slash-command completion. */
+export function useSlashCompletion(_options) {
+    return {
+        completionStart: -1,
+        completionEnd: -1,
+        getCommandFromSuggestion: () => undefined,
+        isArgumentCompletion: false,
+        leafCommand: null,
+    };
+}
+//# sourceMappingURL=useSlashCompletion.js.map

package/build/cli/hooks/useSlashCompletion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSlashCompletion.js","sourceRoot":"","sources":["../../../src/cli/hooks/useSlashCompletion.ts"],"names":[],"mappings":"AAwBA,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CACjC,QAAmC;IAEnC,OAAO;QACN,eAAe,EAAE,CAAC,CAAC;QACnB,aAAa,EAAE,CAAC,CAAC;QACjB,wBAAwB,EAAE,GAAG,EAAE,CAAC,SAAS;QACzC,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE,IAAI;KACjB,CAAC;AACH,CAAC"}

package/build/cli/hooks/useTerminalSize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function useTerminalSize(): {
+    columns: number;
+    rows: number;
+};

package/build/cli/hooks/useTerminalSize.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect, useState } from "react";
+export function useTerminalSize() {
+    const [size, setSize] = useState({
+        columns: process.stdout.columns || 60,
+        rows: process.stdout.rows || 20,
+    });
+    useEffect(() => {
+        function updateSize() {
+            setSize({
+                columns: process.stdout.columns || 60,
+                rows: process.stdout.rows || 20,
+            });
+        }
+        process.stdout.on("resize", updateSize);
+        return () => {
+            process.stdout.off("resize", updateSize);
+        };
+    }, []);
+    return size;
+}
+//# sourceMappingURL=useTerminalSize.js.map

package/build/cli/hooks/useTerminalSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminalSize.js","sourceRoot":"","sources":["../../../src/cli/hooks/useTerminalSize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,UAAU,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC;QAChC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;QACrC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;KAC/B,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACd,SAAS,UAAU;YAClB,OAAO,CAAC;gBACP,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;gBACrC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE;aAC/B,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE;YACX,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACb,CAAC"}

package/build/cli/index.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { AppContainer } from "./AppContainer.js";
+import { debugLogger } from "./utils/debugLogger.js";
+import "dotenv/config";
+async function checkLLMHealth() {
+    const apiUrl = (process.env["LLM_API_URL"] || "http://127.0.0.1:8080").replace(/\/$/, "");
+    try {
+        const response = await fetch(`${apiUrl}/v1/models`);
+        if (!response.ok) {
+            debugLogger.warn(`[CLI] LLM endpoint ${apiUrl} returned ${response.status}. Continuing anyway...`);
+            return;
+        }
+        debugLogger.info(`[CLI] Successfully verified LLM API at ${apiUrl}.`);
+    }
+    catch (_error) {
+        debugLogger.warn(`[CLI] Could not connect to LLM API at ${apiUrl}. Make sure your server is running.`);
+    }
+}
+async function start() {
+    debugLogger.info("App starting - verifying environment.");
+    checkLLMHealth().catch(() => { });
+    const { waitUntilExit } = render(_jsx(AppContainer, {}));
+    await waitUntilExit();
+}
+start();
+//# sourceMappingURL=index.js.map

package/build/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,eAAe,CAAC;AAEvB,KAAK,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,CACd,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,uBAAuB,CACrD,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAErB,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,YAAY,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CACf,sBAAsB,MAAM,aAAa,QAAQ,CAAC,MAAM,wBAAwB,CAChF,CAAC;YACF,OAAO;QACR,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,0CAA0C,MAAM,GAAG,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,IAAI,CACf,yCAAyC,MAAM,qCAAqC,CACpF,CAAC;IACH,CAAC;AACF,CAAC;AAED,KAAK,UAAU,KAAK;IACnB,WAAW,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAC1D,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,KAAC,YAAY,KAAG,CAAC,CAAC;IACnD,MAAM,aAAa,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,EAAE,CAAC"}

package/build/cli/key/keyBindings.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from "zod";
+/**
+ * Command enum for all available keyboard shortcuts
+ */
+import type { Key } from "../hooks/useKeypress.js";
+export declare enum Command {
+    RETURN = "basic.confirm",
+    ESCAPE = "basic.cancel",
+    QUIT = "basic.quit",
+    EXIT = "basic.exit",
+    HOME = "cursor.home",
+    END = "cursor.end",
+    MOVE_UP = "cursor.up",
+    MOVE_DOWN = "cursor.down",
+    MOVE_LEFT = "cursor.left",
+    MOVE_RIGHT = "cursor.right",
+    MOVE_WORD_LEFT = "cursor.wordLeft",
+    MOVE_WORD_RIGHT = "cursor.wordRight",
+    KILL_LINE_RIGHT = "edit.deleteRightAll",
+    KILL_LINE_LEFT = "edit.deleteLeftAll",
+    CLEAR_INPUT = "edit.clear",
+    DELETE_WORD_BACKWARD = "edit.deleteWordLeft",
+    DELETE_WORD_FORWARD = "edit.deleteWordRight",
+    DELETE_CHAR_LEFT = "edit.deleteLeft",
+    DELETE_CHAR_RIGHT = "edit.deleteRight",
+    UNDO = "edit.undo",
+    REDO = "edit.redo",
+    SCROLL_UP = "scroll.up",
+    SCROLL_DOWN = "scroll.down",
+    SCROLL_HOME = "scroll.home",
+    SCROLL_END = "scroll.end",
+    PAGE_UP = "scroll.pageUp",
+    PAGE_DOWN = "scroll.pageDown",
+    HISTORY_UP = "history.previous",
+    HISTORY_DOWN = "history.next",
+    REVERSE_SEARCH = "history.search.start",
+    SUBMIT_REVERSE_SEARCH = "history.search.submit",
+    ACCEPT_SUGGESTION_REVERSE_SEARCH = "history.search.accept",
+    NAVIGATION_UP = "nav.up",
+    NAVIGATION_DOWN = "nav.down",
+    DIALOG_NAVIGATION_UP = "nav.dialog.up",
+    DIALOG_NAVIGATION_DOWN = "nav.dialog.down",
+    DIALOG_NEXT = "nav.dialog.next",
+    DIALOG_PREV = "nav.dialog.previous",
+    ACCEPT_SUGGESTION = "suggest.accept",
+    COMPLETION_UP = "suggest.focusPrevious",
+    COMPLETION_DOWN = "suggest.focusNext",
+    EXPAND_SUGGESTION = "suggest.expand",
+    COLLAPSE_SUGGESTION = "suggest.collapse",
+    SUBMIT = "input.submit",
+    QUEUE_MESSAGE = "input.queueMessage",
+    NEWLINE = "input.newline",
+    OPEN_EXTERNAL_EDITOR = "input.openExternalEditor",
+    DEPRECATED_OPEN_EXTERNAL_EDITOR = "input.deprecatedOpenExternalEditor",
+    PASTE_CLIPBOARD = "input.paste",
+    SHOW_ERROR_DETAILS = "app.showErrorDetails",
+    SHOW_FULL_TODOS = "app.showFullTodos",
+    SHOW_IDE_CONTEXT_DETAIL = "app.showIdeContextDetail",
+    TOGGLE_MARKDOWN = "app.toggleMarkdown",
+    TOGGLE_COPY_MODE = "app.toggleCopyMode",
+    TOGGLE_MOUSE_MODE = "app.toggleMouseMode",
+    TOGGLE_YOLO = "app.toggleYolo",
+    CYCLE_APPROVAL_MODE = "app.cycleApprovalMode",
+    SHOW_MORE_LINES = "app.showMoreLines",
+    EXPAND_PASTE = "app.expandPaste",
+    FOCUS_SHELL_INPUT = "app.focusShellInput",
+    UNFOCUS_SHELL_INPUT = "app.unfocusShellInput",
+    CLEAR_SCREEN = "app.clearScreen",
+    RESTART_APP = "app.restart",
+    SUSPEND_APP = "app.suspend",
+    SHOW_SHELL_INPUT_UNFOCUS_WARNING = "app.showShellUnfocusWarning",
+    BACKGROUND_SHELL_ESCAPE = "background.escape",
+    BACKGROUND_SHELL_SELECT = "background.select",
+    TOGGLE_BACKGROUND_SHELL = "background.toggle",
+    TOGGLE_BACKGROUND_SHELL_LIST = "background.toggleList",
+    KILL_BACKGROUND_SHELL = "background.kill",
+    UNFOCUS_BACKGROUND_SHELL = "background.unfocus",
+    UNFOCUS_BACKGROUND_SHELL_LIST = "background.unfocusList",
+    SHOW_BACKGROUND_SHELL_UNFOCUS_WARNING = "background.unfocusWarning",
+    UPDATE_EXTENSION = "extension.update",
+    LINK_EXTENSION = "extension.link",
+    DUMP_FRAME = "app.dumpFrame",
+    START_RECORDING = "app.startRecording",
+    STOP_RECORDING = "app.stopRecording"
+}
+/**
+ * Data-driven key binding structure for user configuration
+ */
+export declare class KeyBinding {
+    private static readonly VALID_LONG_KEYS;
+    /** The key name (e.g., 'a', 'enter', 'tab', 'escape') */
+    readonly name: string;
+    readonly shift: boolean;
+    readonly alt: boolean;
+    readonly ctrl: boolean;
+    readonly cmd: boolean;
+    constructor(pattern: string);
+    matches(key: Key): boolean;
+    equals(other: KeyBinding): boolean;
+}
+/**
+ * Configuration type mapping commands to their key bindings
+ */
+export type KeyBindingConfig = Map<Command, readonly KeyBinding[]>;
+/**
+ * Default key binding configuration
+ * Matches the original hard-coded logic exactly
+ */
+export declare const defaultKeyBindingConfig: KeyBindingConfig;
+interface CommandCategory {
+    readonly title: string;
+    readonly commands: readonly Command[];
+}
+/**
+ * Presentation metadata for grouping commands in documentation or UI.
+ */
+export declare const commandCategories: readonly CommandCategory[];
+/**
+ * Human-readable descriptions for each command, used in docs/tooling.
+ */
+export declare const commandDescriptions: Readonly<Record<Command, string>>;
+export declare const keybindingsSchema: z.ZodArray<z.ZodEffects<z.ZodObject<{
+    command: z.ZodEffects<z.ZodString, {
+        command: Command;
+        negate: boolean;
+    }, string>;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    command: {
+        command: Command;
+        negate: boolean;
+    };
+}, {
+    key: string;
+    command: string;
+}>, {
+    commandEntry: {
+        command: Command;
+        negate: boolean;
+    };
+    key: string;
+}, {
+    key: string;
+    command: string;
+}>, "many">;
+export {};