@letta-ai/letta-code 0.30.2 → 0.30.4

package/dist/types/hooks/types.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Tool-related hook events that require matchers to specify which tools to match
+ */
+export type ToolHookEvent = "PreToolUse" | "PostToolUse" | "PostToolUseFailure" | "PermissionRequest";
+/**
+ * Simple hook events that don't require matchers
+ */
+export type SimpleHookEvent = "UserPromptSubmit" | "Notification" | "Stop" | "SubagentStop" | "PreCompact" | "SessionStart" | "SessionEnd";
+/**
+ * All hook event types
+ */
+export type HookEvent = ToolHookEvent | SimpleHookEvent;
+/**
+ * Command hook configuration - executes a shell command
+ */
+export interface CommandHookConfig {
+    /** Type of hook */
+    type: "command";
+    /** Shell command to execute */
+    command: string;
+    /** Optional timeout in milliseconds (default: 60000 for command hooks) */
+    timeout?: number;
+    /** When true, suppress hook output in the TUI */
+    quiet?: boolean;
+}
+/**
+ * Prompt hook configuration - sends hook input to an LLM for evaluation.
+ * Supported events: PreToolUse, PostToolUse, PostToolUseFailure,
+ * PermissionRequest, UserPromptSubmit, Stop, and SubagentStop.
+ */
+export interface PromptHookConfig {
+    /** Type of hook */
+    type: "prompt";
+    /**
+     * Prompt text to send to the model.
+     * Use $ARGUMENTS as a placeholder for the hook input JSON.
+     */
+    prompt: string;
+    /** Optional model to use for evaluation */
+    model?: string;
+    /** Optional timeout in milliseconds (default: 30000 for prompt hooks) */
+    timeout?: number;
+    /** When true, suppress hook output in the TUI */
+    quiet?: boolean;
+}
+/**
+ * Placeholder for $ARGUMENTS in prompt hooks
+ */
+export declare const PROMPT_ARGUMENTS_PLACEHOLDER = "$ARGUMENTS";
+/**
+ * Events that support prompt-based hooks:
+ * PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest,
+ * UserPromptSubmit, Stop, SubagentStop
+ */
+export declare const PROMPT_HOOK_SUPPORTED_EVENTS: Set<HookEvent>;
+/**
+ * Type guard to check if an event supports prompt hooks
+ */
+export declare function supportsPromptHooks(event: HookEvent): boolean;
+/**
+ * Individual hook configuration - can be command or prompt type
+ */
+export type HookCommand = CommandHookConfig | PromptHookConfig;
+/**
+ * Type guard to check if a hook is a command hook
+ */
+export declare function isCommandHook(hook: HookCommand): hook is CommandHookConfig;
+/**
+ * Type guard to check if a hook is a prompt hook
+ */
+export declare function isPromptHook(hook: HookCommand): hook is PromptHookConfig;
+/**
+ * Hook matcher configuration for tool events - matches hooks to specific tools
+ */
+export interface HookMatcher {
+    /**
+     * Tool name pattern to match:
+     * - Exact name: "Bash", "Edit", "Write"
+     * - Multiple tools: "Edit|Write"
+     * - All tools: "*" or ""
+     */
+    matcher: string;
+    /** List of hooks to run when matched */
+    hooks: HookCommand[];
+}
+/**
+ * Simple hook matcher for non-tool events - no matcher needed, just hooks
+ */
+export interface SimpleHookMatcher {
+    /** List of hooks to run */
+    hooks: HookCommand[];
+}
+/**
+ * Full hooks configuration stored in settings
+ * - Tool events (PreToolUse, PostToolUse, PermissionRequest) use HookMatcher[] with matcher patterns
+ * - Simple events use SimpleHookMatcher[] (same structure, just no matcher field)
+ * - disabled: when true, prevents all hooks from firing (checked across all config levels)
+ */
+export type HooksConfig = {
+    /** When true, disables all hooks. User false overrides project settings; otherwise any true disables. */
+    disabled?: boolean;
+} & {
+    [K in ToolHookEvent]?: HookMatcher[];
+} & {
+    [K in SimpleHookEvent]?: SimpleHookMatcher[];
+};
+/**
+ * Set of tool events that require matchers
+ */
+export declare const TOOL_EVENTS: Set<HookEvent>;
+/**
+ * Type guard to check if an event is a tool event
+ */
+export declare function isToolEvent(event: HookEvent): event is ToolHookEvent;
+/**
+ * Exit codes from hook execution
+ */
+export declare enum HookExitCode {
+    /** Allow/continue - hook completed successfully, proceed with action */
+    ALLOW = 0,
+    /** Error - hook encountered an error */
+    ERROR = 1,
+    /** Block/deny - hook requests to block the action */
+    BLOCK = 2
+}
+/**
+ * Result of executing a single hook
+ */
+export interface HookResult {
+    /** Exit code from the hook command */
+    exitCode: HookExitCode;
+    /** Standard output from the hook */
+    stdout: string;
+    /** Standard error from the hook */
+    stderr: string;
+    /** Whether the hook timed out */
+    timedOut: boolean;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Error message if hook failed to execute */
+    error?: string;
+}
+/**
+ * Expected JSON response structure from prompt hooks.
+ * The LLM must respond with this schema per Claude Code spec.
+ */
+export interface PromptHookResponse {
+    /** true allows the action, false prevents it */
+    ok: boolean;
+    /** Required when ok is false. Explanation shown to Claude. */
+    reason?: string;
+}
+/**
+ * Aggregated result from running all matched hooks
+ */
+export interface HookExecutionResult {
+    /** Whether any hook blocked the action */
+    blocked: boolean;
+    /** Whether any hook errored */
+    errored: boolean;
+    /** Feedback messages from hooks (stdout when blocking) */
+    feedback: string[];
+    /** Individual results from each hook */
+    results: HookResult[];
+    /** Rewritten tool input from a hook (PreToolUse updatedInput protocol) */
+    updatedInput?: Record<string, unknown>;
+}
+/**
+ * Base input structure sent to all hooks
+ */
+export interface HookInputBase {
+    /** The event type that triggered this hook */
+    event_type: HookEvent;
+    /** Working directory */
+    working_directory: string;
+    /** Session ID if available */
+    session_id?: string;
+}
+/**
+ * Input for PreToolUse hooks
+ */
+export interface PreToolUseHookInput extends HookInputBase {
+    event_type: "PreToolUse";
+    /** Name of the tool being used */
+    tool_name: string;
+    /** Tool input arguments */
+    tool_input: Record<string, unknown>;
+    /** Tool call ID */
+    tool_call_id?: string;
+    /** Agent ID (for server-side tools like memory) */
+    agent_id?: string;
+}
+/**
+ * Input for PostToolUse hooks
+ */
+export interface PostToolUseHookInput extends HookInputBase {
+    event_type: "PostToolUse";
+    /** Name of the tool that was used */
+    tool_name: string;
+    /** Tool input arguments */
+    tool_input: Record<string, unknown>;
+    /** Tool call ID */
+    tool_call_id?: string;
+    /** Tool execution result */
+    tool_result?: {
+        status: "success" | "error";
+        output?: string;
+    };
+    /** Agent ID (for server-side tools like memory) */
+    agent_id?: string;
+    /** Reasoning/thinking content that preceded this tool call */
+    preceding_reasoning?: string;
+    /** Assistant message content that preceded this tool call */
+    preceding_assistant_message?: string;
+}
+/**
+ * Input for PostToolUseFailure hooks
+ * Triggered after a tool call fails. Non-blocking, but stderr is fed back to the agent.
+ */
+export interface PostToolUseFailureHookInput extends HookInputBase {
+    event_type: "PostToolUseFailure";
+    /** Name of the tool that failed */
+    tool_name: string;
+    /** Tool input arguments */
+    tool_input: Record<string, unknown>;
+    /** Tool call ID */
+    tool_call_id?: string;
+    /** Error message from the tool failure */
+    error_message: string;
+    /** Error type/name (e.g., "AbortError", "TypeError") */
+    error_type?: string;
+    /** Agent ID (for server-side tools like memory) */
+    agent_id?: string;
+    /** Reasoning/thinking content that preceded this tool call */
+    preceding_reasoning?: string;
+    /** Assistant message content that preceded this tool call */
+    preceding_assistant_message?: string;
+}
+/**
+ * Input for PermissionRequest hooks
+ */
+export interface PermissionRequestHookInput extends HookInputBase {
+    event_type: "PermissionRequest";
+    /** Name of the tool requesting permission */
+    tool_name: string;
+    /** Tool input arguments */
+    tool_input: Record<string, unknown>;
+    /** Agent ID if available */
+    agent_id?: string;
+    /** Permission being requested */
+    permission: {
+        type: "allow" | "deny" | "ask";
+        scope?: "session" | "project" | "user";
+    };
+    /** Current session permissions (in-memory only, cleared on exit) */
+    session_permissions?: {
+        allow?: string[];
+        deny?: string[];
+        ask?: string[];
+    };
+}
+/**
+ * Input for UserPromptSubmit hooks
+ */
+export interface UserPromptSubmitHookInput extends HookInputBase {
+    event_type: "UserPromptSubmit";
+    /** The user's prompt text */
+    prompt: string;
+    /** Whether this is a command (starts with /) */
+    is_command: boolean;
+    /** Agent ID if available */
+    agent_id?: string;
+    /** Conversation ID if available */
+    conversation_id?: string;
+}
+/**
+ * Input for Notification hooks
+ */
+export interface NotificationHookInput extends HookInputBase {
+    event_type: "Notification";
+    /** Notification message */
+    message: string;
+    /** Notification type/level */
+    level?: "info" | "warning" | "error";
+}
+/**
+ * Input for Stop hooks
+ */
+export interface StopHookInput extends HookInputBase {
+    event_type: "Stop";
+    /** Stop reason from the API */
+    stop_reason: string;
+    /** Number of messages in the turn */
+    message_count?: number;
+    /** Number of tool calls in the turn */
+    tool_call_count?: number;
+    /** Reasoning/thinking content that preceded the final response */
+    preceding_reasoning?: string;
+    /** The assistant's final message content */
+    assistant_message?: string;
+    /** The user's original prompt that initiated this turn */
+    user_message?: string;
+}
+/**
+ * Input for SubagentStop hooks
+ */
+export interface SubagentStopHookInput extends HookInputBase {
+    event_type: "SubagentStop";
+    /** Subagent type */
+    subagent_type: string;
+    /** Subagent ID */
+    subagent_id: string;
+    /** Whether subagent succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Subagent's agent ID */
+    agent_id?: string;
+    /** Subagent's conversation ID */
+    conversation_id?: string;
+}
+/**
+ * Input for PreCompact hooks
+ */
+export interface PreCompactHookInput extends HookInputBase {
+    event_type: "PreCompact";
+    /** Current context length */
+    context_length?: number;
+    /** Maximum context length */
+    max_context_length?: number;
+    /** Agent ID */
+    agent_id?: string;
+    /** Conversation ID */
+    conversation_id?: string;
+}
+/**
+ * Input for SessionStart hooks
+ */
+export interface SessionStartHookInput extends HookInputBase {
+    event_type: "SessionStart";
+    /** Whether this is a new session or resumed */
+    is_new_session: boolean;
+    /** Agent ID */
+    agent_id?: string;
+    /** Agent name */
+    agent_name?: string;
+    /** Conversation ID */
+    conversation_id?: string;
+}
+/**
+ * Input for SessionEnd hooks
+ */
+export interface SessionEndHookInput extends HookInputBase {
+    event_type: "SessionEnd";
+    /** Session duration in milliseconds */
+    duration_ms?: number;
+    /** Total messages in session */
+    message_count?: number;
+    /** Total tool calls in session */
+    tool_call_count?: number;
+    /** Agent ID */
+    agent_id?: string;
+    /** Conversation ID */
+    conversation_id?: string;
+}
+/**
+ * Union type for all hook inputs
+ */
+export type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | PermissionRequestHookInput | UserPromptSubmitHookInput | NotificationHookInput | StopHookInput | SubagentStopHookInput | PreCompactHookInput | SessionStartHookInput | SessionEndHookInput;
+//# sourceMappingURL=types.d.ts.map

package/dist/types/hooks/types.d.ts.map

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

package/dist/types/lsp/client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LSP Client - Handles JSON-RPC communication with LSP servers
+ */
+import { EventEmitter } from "node:events";
+import type { InitializeResult, LSPServerProcess } from "./types.js";
+export interface LSPClientOptions {
+    serverID: string;
+    server: LSPServerProcess;
+    rootUri: string;
+}
+/**
+ * LSP Client that communicates with an LSP server via JSON-RPC over STDIO
+ */
+export declare class LSPClient extends EventEmitter {
+    private process;
+    private rootUri;
+    private stdin;
+    private stdout;
+    private requestId;
+    private pendingRequests;
+    private buffer;
+    private initialized;
+    constructor(options: LSPClientOptions);
+    private setupListeners;
+    private processBuffer;
+    private handleMessage;
+    private sendRequest;
+    private sendNotification;
+    private sendMessage;
+    /**
+     * Initialize the LSP server
+     */
+    initialize(): Promise<InitializeResult>;
+    /**
+     * Notify server that a document was opened
+     */
+    didOpen(uri: string, languageId: string, version: number, text: string): void;
+    /**
+     * Notify server that a document was changed
+     */
+    didChange(uri: string, version: number, text: string): void;
+    /**
+     * Notify server that a document was closed
+     */
+    didClose(uri: string): void;
+    /**
+     * Shutdown the LSP server gracefully
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/lsp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/lsp/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAGV,gBAAgB,EAIhB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAMnB;IACJ,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,gBAAgB;IAgBrC,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2B7C;;OAEG;IACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,IAAI;IAaP;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgB3D;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAU3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}

package/dist/types/lsp/manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LSP Manager - Orchestrates multiple LSP servers and maintains diagnostics
+ */
+import type { Diagnostic } from "./types.js";
+/**
+ * Global LSP Manager singleton
+ * Manages LSP servers and aggregates diagnostics
+ */
+export declare class LSPManager {
+    private static instance;
+    private servers;
+    private diagnostics;
+    private openDocuments;
+    private serverDefinitions;
+    private enabled;
+    private constructor();
+    static getInstance(): LSPManager;
+    /**
+     * Initialize LSP system for a project
+     */
+    initialize(projectRoot: string): Promise<void>;
+    /**
+     * Get or start LSP server for a file
+     */
+    private getOrStartServer;
+    /**
+     * Notify LSP that a file was opened or touched
+     */
+    touchFile(filePath: string, changed: boolean): Promise<void>;
+    /**
+     * Update diagnostics for a file
+     */
+    private updateDiagnostics;
+    /**
+     * Get diagnostics for a specific file
+     */
+    getDiagnostics(filePath?: string): Diagnostic[];
+    /**
+     * Get language ID for a file
+     */
+    private getLanguageId;
+    /**
+     * Shutdown all LSP servers
+     */
+    shutdown(): Promise<void>;
+}
+export declare const lspManager: LSPManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/lsp/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/lsp/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAQ5D;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,aAAa,CAAuD;IAC5E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,UAAU;IAOhC;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepD;;OAEG;YACW,gBAAgB;IA2F9B;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmClE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAkB/C;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhC;AAGD,eAAO,MAAM,UAAU,YAA2B,CAAC"}

package/dist/types/lsp/servers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * LSP Server Registry
+ */
+import type { LSPServerInfo } from "../types.js";
+/**
+ * All available LSP servers
+ * Add new servers here as they are implemented
+ */
+export declare const SERVERS: LSPServerInfo[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lsp/servers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lsp/servers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,aAAa,EAAqC,CAAC"}

package/dist/types/lsp/servers/python.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Python LSP Server Definition
+ * Uses Pyright language server
+ */
+import type { LSPServerInfo } from "../types.js";
+/**
+ * Python Language Server (Pyright)
+ * High-performance static type checker for Python
+ */
+export declare const PythonServer: LSPServerInfo;
+//# sourceMappingURL=python.d.ts.map

package/dist/types/lsp/servers/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../../src/lsp/servers/python.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,aAyD1B,CAAC"}

package/dist/types/lsp/servers/typescript.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TypeScript/JavaScript LSP Server Definition
+ */
+import type { LSPServerInfo } from "../types.js";
+/**
+ * TypeScript Language Server
+ * Uses typescript-language-server + typescript
+ */
+export declare const TypeScriptServer: LSPServerInfo;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/types/lsp/servers/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../../src/lsp/servers/typescript.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAyD9B,CAAC"}

package/dist/types/lsp/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * LSP Infrastructure Types
+ * Based on Language Server Protocol specification
+ */
+import type { ChildProcess } from "node:child_process";
+/**
+ * LSP Diagnostic severity levels
+ */
+export declare enum DiagnosticSeverity {
+    Error = 1,
+    Warning = 2,
+    Information = 3,
+    Hint = 4
+}
+/**
+ * Position in a text document (0-based)
+ */
+export interface Position {
+    line: number;
+    character: number;
+}
+/**
+ * Range in a text document
+ */
+export interface Range {
+    start: Position;
+    end: Position;
+}
+/**
+ * LSP Diagnostic
+ */
+export interface Diagnostic {
+    range: Range;
+    severity?: DiagnosticSeverity;
+    code?: string | number;
+    source?: string;
+    message: string;
+    relatedInformation?: DiagnosticRelatedInformation[];
+}
+export interface DiagnosticRelatedInformation {
+    location: Location;
+    message: string;
+}
+export interface Location {
+    uri: string;
+    range: Range;
+}
+/**
+ * LSP Server process handle
+ */
+export interface LSPServerProcess {
+    process: ChildProcess;
+    initialization?: Record<string, unknown>;
+}
+/**
+ * LSP Server definition
+ */
+export interface LSPServerInfo {
+    id: string;
+    extensions: string[];
+    command: string[];
+    env?: Record<string, string>;
+    initialization?: Record<string, unknown>;
+    autoInstall?: {
+        check: () => Promise<boolean>;
+        install: () => Promise<void>;
+    };
+}
+/**
+ * Text document for LSP
+ */
+export interface TextDocument {
+    uri: string;
+    languageId: string;
+    version: number;
+    text: string;
+}
+/**
+ * JSON-RPC Request
+ */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: number | string;
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC Response
+ */
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: number | string;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * JSON-RPC Notification
+ */
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}
+/**
+ * LSP Initialize params
+ */
+export interface InitializeParams {
+    processId: number | null;
+    rootUri: string | null;
+    capabilities: ClientCapabilities;
+    initializationOptions?: unknown;
+}
+export interface ClientCapabilities {
+    textDocument?: {
+        publishDiagnostics?: {
+            relatedInformation?: boolean;
+            tagSupport?: {
+                valueSet: number[];
+            };
+            versionSupport?: boolean;
+        };
+    };
+}
+/**
+ * LSP Initialize result
+ */
+export interface InitializeResult {
+    capabilities: ServerCapabilities;
+    serverInfo?: {
+        name: string;
+        version?: string;
+    };
+}
+export interface ServerCapabilities {
+    textDocumentSync?: number | TextDocumentSyncOptions;
+}
+export interface TextDocumentSyncOptions {
+    openClose?: boolean;
+    change?: number;
+}
+//# sourceMappingURL=types.d.ts.map