@opticlm/connector 2.2.0 → 2.3.1

package/README.md

@@ -343,7 +343,7 @@ When the MCP server runs in a separate process from the IDE plugin (e.g., spawne
 **IDE plugin side** — expose providers:
 
 ```typescript
-import { servePipe } from '@opticlm/connector'
+import { servePipe } from '@opticlm/connector/pipe'
 
 const server = await servePipe({
   pipeName: 'my-ide-lsp',
@@ -361,7 +361,7 @@ const server = await servePipe({
 
 ```typescript
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import { connectPipe } from '@opticlm/connector'
+import { connectPipe } from '@opticlm/connector/pipe'
 import { install } from '@opticlm/connector/mcp'
 
 const conn = await connectPipe({

package/dist/index.d.ts

@@ -1,45 +1,70 @@
-import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider } from './interfaces-wSmWeYxt.js';
-export { C as CodeSnippet, d as Diagnostic, e as DiagnosticSeverity, f as DiskRange, g as DocumentSymbol, h as EditFailureReason, i as EditResult, j as ExactPosition, k as Frontmatter, l as FrontmatterMatch, m as FrontmatterValue, n as FuzzyPosition, o as GlobalFindMatch, p as GlobalFindOptions, L as Link, q as OnDiagnosticsChangedCallback, P as PendingEditOperation, S as SymbolKind, T as TextEdit, U as UnifiedUri } from './interfaces-wSmWeYxt.js';
-export { R as ResolverConfig, S as SymbolResolutionError, a as SymbolResolver } from './resolver-CSuvobsJ.js';
+import { F as FileAccessProvider, U as UnifiedUri, l as FuzzyPosition, j as ExactPosition } from './interfaces-B9NK_71f.js';
+export { C as CodeSnippet, D as DefinitionProvider, h as Diagnostic, g as DiagnosticSeverity, a as DiagnosticsProvider, k as DiskRange, i as DocumentSymbol, m as EditFailureReason, E as EditProvider, d as EditResult, n as Frontmatter, e as FrontmatterMatch, c as FrontmatterProvider, o as FrontmatterValue, f as GlobalFindMatch, p as GlobalFindOptions, G as GlobalFindProvider, b as GraphProvider, H as HierarchyProvider, L as Link, q as OnDiagnosticsChangedCallback, O as OutlineProvider, P as PendingEditOperation, R as ReferencesProvider, S as SymbolKind, T as TextEdit } from './interfaces-B9NK_71f.js';
 
-interface connectPipeOptions {
-    pipeName: string;
-    connectTimeout?: number;
-}
-interface LspPipeConnection {
-    readonly fileAccess?: FileAccessProvider;
-    readonly edit?: EditProvider;
-    readonly definition?: DefinitionProvider;
-    readonly references?: ReferencesProvider;
-    readonly hierarchy?: HierarchyProvider;
-    readonly diagnostics?: DiagnosticsProvider;
-    readonly outline?: OutlineProvider;
-    readonly globalFind?: GlobalFindProvider;
-    readonly graph?: GraphProvider;
-    readonly frontmatter?: FrontmatterProvider;
-    readonly availableMethods: string[];
-    disconnect(): void;
-}
-declare function connectPipe(options: connectPipeOptions): Promise<LspPipeConnection>;
+/**
+ * Smart Resolver Logic for MCP LSP Driver SDK
+ *
+ * This is the internal engine of the SDK. It translates the LLM's imprecise
+ * instructions into precise coordinates.
+ */
 
-interface servePipeOptions {
-    pipeName: string;
-    fileAccess: FileAccessProvider;
-    edit?: EditProvider;
-    definition?: DefinitionProvider;
-    references?: ReferencesProvider;
-    hierarchy?: HierarchyProvider;
-    diagnostics?: DiagnosticsProvider;
-    outline?: OutlineProvider;
-    globalFind?: GlobalFindProvider;
-    graph?: GraphProvider;
-    frontmatter?: FrontmatterProvider;
+/**
+ * Configuration options for the SymbolResolver.
+ */
+interface ResolverConfig {
+    /**
+     * Number of lines to scan above and below the lineHint if the symbol
+     * is not found at the exact line. Defaults to 2.
+     */
+    lineSearchRadius?: number;
+}
+/**
+ * Error thrown when a symbol cannot be resolved.
+ */
+declare class SymbolResolutionError extends Error {
+    readonly symbolName: string;
+    readonly lineHint: number;
+    readonly reason: string;
+    constructor(symbolName: string, lineHint: number, reason: string);
 }
-interface LspPipeServer {
-    readonly pipePath: string;
-    readonly connectionCount: number;
-    close(): Promise<void>;
+/**
+ * The SymbolResolver translates fuzzy positions (as provided by an LLM)
+ * into exact positions that can be used by the IDE.
+ *
+ * Algorithm:
+ * 1. Read file content via FileAccessProvider.
+ * 2. Split content into lines.
+ * 3. Target the lineHint (converting 1-based to 0-based).
+ * 4. Search for symbolName in that line.
+ *    - If orderHint is 0, find first occurrence.
+ *    - If orderHint is N, find Nth occurrence.
+ * 5. Robustness Fallback:
+ *    - If the line is empty or symbol not found at lineHint,
+ *      scan +/- lineSearchRadius lines to handle minor line shifts.
+ * 6. Return ExactPosition (line, character start index).
+ */
+declare class SymbolResolver {
+    private readonly fs;
+    private readonly lineSearchRadius;
+    constructor(fs: FileAccessProvider, config?: ResolverConfig);
+    /**
+     * Resolves a fuzzy position to an exact position.
+     *
+     * @param uri - The URI of the file
+     * @param fuzzy - The fuzzy position provided by the LLM
+     * @returns The exact position in the file
+     * @throws SymbolResolutionError if the symbol cannot be found
+     */
+    resolvePosition(uri: UnifiedUri, fuzzy: FuzzyPosition): Promise<ExactPosition>;
+    /**
+     * Finds the Nth occurrence of a symbol in a line.
+     *
+     * @param line - The line to search in (may be undefined if out of bounds)
+     * @param symbolName - The symbol to find
+     * @param orderHint - Which occurrence to find (0-based)
+     * @returns The character offset of the symbol, or null if not found
+     */
+    private findSymbolInLine;
 }
-declare function servePipe(options: servePipeOptions): Promise<LspPipeServer>;
 
-export { DefinitionProvider, DiagnosticsProvider, EditProvider, FileAccessProvider, FrontmatterProvider, GlobalFindProvider, GraphProvider, HierarchyProvider, type LspPipeConnection, type LspPipeServer, OutlineProvider, ReferencesProvider, connectPipe, type connectPipeOptions, servePipe, type servePipeOptions };
+export { ExactPosition, FileAccessProvider, FuzzyPosition, type ResolverConfig, SymbolResolutionError, SymbolResolver, UnifiedUri };

package/dist/index.js

@@ -1,6 +1 @@
-import {connect,createServer}from'net';import {unlinkSync}from'fs';var v=class{socket;requestHandler;notificationHandler;nextId=1;pending=new Map;buffer="";destroyed=false;constructor(r,e){this.socket=r,this.requestHandler=e?.onRequest,this.notificationHandler=e?.onNotification,r.on("data",i=>this.handleData(i)),r.on("close",()=>this.rejectAll(new Error("Connection closed"))),r.on("error",i=>this.rejectAll(i));}sendRequest(r,e){return this.destroyed?Promise.reject(new Error("Transport destroyed")):new Promise((i,o)=>{let n=this.nextId++;this.pending.set(n,{resolve:i,reject:o});let a={type:"request",id:n,method:r,params:e};this.socket.write(`${JSON.stringify(a)}
-`);})}sendNotification(r,e){if(this.destroyed)return;let i={type:"notification",method:r,params:e};this.socket.write(`${JSON.stringify(i)}
-`);}destroy(){this.destroyed||(this.destroyed=true,this.rejectAll(new Error("Transport destroyed")),this.socket.destroy());}handleData(r){this.buffer+=r.toString();let e=this.buffer.split(`
-`);this.buffer=e.pop()??"";for(let i of e){let o=i.replace(/\r$/,"");if(o)try{let n=JSON.parse(o);this.dispatch(n);}catch{}}}dispatch(r){switch(r.type){case "response":{let e=this.pending.get(r.id);e&&(this.pending.delete(r.id),r.error?e.reject(new Error(r.error.message)):e.resolve(r.result));break}case "request":{this.requestHandler&&this.requestHandler(r.method,r.params).then(e=>{if(this.destroyed)return;let i={type:"response",id:r.id,result:e};this.socket.write(`${JSON.stringify(i)}
-`);}).catch(e=>{if(this.destroyed)return;let i={type:"response",id:r.id,error:{message:e instanceof Error?e.message:String(e)}};this.socket.write(`${JSON.stringify(i)}
-`);});break}case "notification":{this.notificationHandler?.(r.method,r.params);break}}}rejectAll(r){for(let[,e]of this.pending)e.reject(r);this.pending.clear();}};function w(l){return process.platform==="win32"?`\\\\.\\pipe\\${l}`:`/tmp/${l}.sock`}var b=[{providerKey:"fileAccess",methods:["readFile","readDirectory"]},{providerKey:"edit",methods:["applyEdits","previewAndApplyEdits"]},{providerKey:"definition",methods:["provideDefinition"]},{providerKey:"references",methods:["provideReferences"]},{providerKey:"hierarchy",methods:["provideCallHierarchy"]},{providerKey:"diagnostics",methods:["provideDiagnostics","getWorkspaceDiagnostics"]},{providerKey:"outline",methods:["provideDocumentSymbols"]},{providerKey:"globalFind",methods:["globalFind"]},{providerKey:"graph",methods:["getLinkStructure","resolveOutlinks","resolveBacklinks","addLink"]},{providerKey:"frontmatter",methods:["getFrontmatterStructure","getFrontmatter","setFrontmatter"]}];function C(l){let{pipeName:r,connectTimeout:e=5e3}=l,i=w(r);return new Promise((o,n)=>{let a=connect(i),t=false,d=setTimeout(()=>{t||(t=true,a.destroy(),n(new Error(`Connection timeout after ${e}ms`)));},e);a.on("error",s=>{t||(t=true,clearTimeout(d),n(s));}),a.on("connect",()=>{if(clearTimeout(d),t)return;let s,p,c=new v(a,{onNotification:(u,m)=>{u==="onDiagnosticsChanged"&&s&&s(m[0]),u==="onFileChanged"&&p&&p(m[0]);}});c.sendRequest("_handshake",[]).then(u=>{if(t)return;let g=u.methods,f={};for(let{providerKey:P,methods:D}of b){let R=D.filter(h=>g.includes(`${P}.${h}`));if(R.length===0)continue;let y={};for(let h of R)y[h]=(...E)=>c.sendRequest(`${P}.${h}`,E);P==="diagnostics"&&g.includes("onDiagnosticsChanged")&&(y.onDiagnosticsChanged=h=>{s=h;}),P==="fileAccess"&&g.includes("onFileChanged")&&(y.onFileChanged=h=>{p=h;}),f[P]=y;}t=true,o({fileAccess:f.fileAccess,edit:f.edit,definition:f.definition,references:f.references,hierarchy:f.hierarchy,diagnostics:f.diagnostics,outline:f.outline,globalFind:f.globalFind,graph:f.graph,frontmatter:f.frontmatter,availableMethods:g,disconnect(){c.destroy();}});}).catch(u=>{t||(t=true,c.destroy(),n(u instanceof Error?u:new Error(String(u))));});});})}function A(l){let{pipeName:r}=l,e=w(r),i=new Map;for(let{providerKey:t,methods:d}of b){let s=l[t];if(s)for(let p of d){let c=s[p];if(typeof c=="function"){let u=`${t}.${p}`;i.set(u,(...m)=>c.apply(s,m));}}}let o=[...i.keys()];l.diagnostics?.onDiagnosticsChanged&&o.push("onDiagnosticsChanged"),l.fileAccess.onFileChanged&&o.push("onFileChanged");let n=new Set,a=createServer(t=>{let d=new v(t,{onRequest:async(s,p)=>{if(s==="_handshake")return {methods:o};let c=i.get(s);if(!c)throw new Error(`Unknown method: ${s}`);return c(...p)}});n.add(d),t.on("close",()=>n.delete(d));});return l.diagnostics?.onDiagnosticsChanged&&l.diagnostics.onDiagnosticsChanged(t=>{for(let d of n)d.sendNotification("onDiagnosticsChanged",[t]);}),l.fileAccess.onFileChanged&&l.fileAccess.onFileChanged(t=>{for(let d of n)d.sendNotification("onFileChanged",[t]);}),new Promise((t,d)=>{if(process.platform!=="win32")try{unlinkSync(e);}catch{}a.on("error",d),a.listen(e,()=>{a.removeListener("error",d),t({get pipePath(){return e},get connectionCount(){return n.size},async close(){for(let s of n)s.destroy();if(n.clear(),await new Promise((s,p)=>{a.close(c=>{c?p(c):s();});}),process.platform!=="win32")try{unlinkSync(e);}catch{}}});});})}var k=class extends Error{constructor(e,i,o){super(`Could not find symbol '${e}' at or near line ${i}. ${o}`);this.symbolName=e;this.lineHint=i;this.reason=o;this.name="SymbolResolutionError";}},F=class{constructor(r,e){this.fs=r;this.lineSearchRadius=e?.lineSearchRadius??2;}lineSearchRadius;async resolvePosition(r,e){let o=(await this.fs.readFile(r)).split(/\r?\n/),n=e.lineHint-1,a=e.orderHint??0,t=this.findSymbolInLine(o[n],e.symbolName,a);if(t!==null)return {line:n,character:t};for(let d=1;d<=this.lineSearchRadius;d++){let s=n-d;if(s>=0){let c=this.findSymbolInLine(o[s],e.symbolName,a);if(c!==null)return {line:s,character:c}}let p=n+d;if(p<o.length){let c=this.findSymbolInLine(o[p],e.symbolName,a);if(c!==null)return {line:p,character:c}}}throw new k(e.symbolName,e.lineHint,`Please verify the file content and try again. Searched lines ${Math.max(1,e.lineHint-this.lineSearchRadius)} to ${Math.min(o.length,e.lineHint+this.lineSearchRadius)}.`)}findSymbolInLine(r,e,i){if(r===void 0||r.length===0)return null;let o=0,n=0;for(;o<r.length;){let a=r.indexOf(e,o);if(a===-1)break;if(n===i)return a;n++,o=a+1;}return null}};export{k as SymbolResolutionError,F as SymbolResolver,C as connectPipe,A as servePipe};
+var a=class extends Error{constructor(e,s,i){super(`Could not find symbol '${e}' at or near line ${s}. ${i}`);this.symbolName=e;this.lineHint=s;this.reason=i;this.name="SymbolResolutionError";}},u=class{constructor(n,e){this.fs=n;this.lineSearchRadius=e?.lineSearchRadius??2;}lineSearchRadius;async resolvePosition(n,e){let i=(await this.fs.readFile(n)).split(/\r?\n/),r=e.lineHint-1,t=e.orderHint??0,m=this.findSymbolInLine(i[r],e.symbolName,t);if(m!==null)return {line:r,character:m};for(let l=1;l<=this.lineSearchRadius;l++){let c=r-l;if(c>=0){let o=this.findSymbolInLine(i[c],e.symbolName,t);if(o!==null)return {line:c,character:o}}let d=r+l;if(d<i.length){let o=this.findSymbolInLine(i[d],e.symbolName,t);if(o!==null)return {line:d,character:o}}}throw new a(e.symbolName,e.lineHint,`Please verify the file content and try again. Searched lines ${Math.max(1,e.lineHint-this.lineSearchRadius)} to ${Math.min(i.length,e.lineHint+this.lineSearchRadius)}.`)}findSymbolInLine(n,e,s){if(n===void 0||n.length===0)return null;let i=0,r=0;for(;i<n.length;){let t=n.indexOf(e,i);if(t===-1)break;if(r===s)return t;r++,i=t+1;}return null}};export{a as SymbolResolutionError,u as SymbolResolver};

package/dist/{interfaces-wSmWeYxt.d.ts → interfaces-B9NK_71f.d.ts}

@@ -442,4 +442,4 @@ interface EditProvider {
     previewAndApplyEdits?(operation: PendingEditOperation): Promise<boolean>;
 }
 
-export type { CodeSnippet as C, DefinitionProvider as D, EditProvider as E, FileAccessProvider as F, GlobalFindProvider as G, HierarchyProvider as H, Link as L, OutlineProvider as O, PendingEditOperation as P, ReferencesProvider as R, SymbolKind as S, TextEdit as T, UnifiedUri as U, DiagnosticsProvider as a, GraphProvider as b, FrontmatterProvider as c, Diagnostic as d, DiagnosticSeverity as e, DiskRange as f, DocumentSymbol as g, EditFailureReason as h, EditResult as i, ExactPosition as j, Frontmatter as k, FrontmatterMatch as l, FrontmatterValue as m, FuzzyPosition as n, GlobalFindMatch as o, GlobalFindOptions as p, OnDiagnosticsChangedCallback as q };
+export type { CodeSnippet as C, DefinitionProvider as D, EditProvider as E, FileAccessProvider as F, GlobalFindProvider as G, HierarchyProvider as H, Link as L, OutlineProvider as O, PendingEditOperation as P, ReferencesProvider as R, SymbolKind as S, TextEdit as T, UnifiedUri as U, DiagnosticsProvider as a, GraphProvider as b, FrontmatterProvider as c, EditResult as d, FrontmatterMatch as e, GlobalFindMatch as f, DiagnosticSeverity as g, Diagnostic as h, DocumentSymbol as i, ExactPosition as j, DiskRange as k, FuzzyPosition as l, EditFailureReason as m, Frontmatter as n, FrontmatterValue as o, GlobalFindOptions as p, OnDiagnosticsChangedCallback as q };

package/dist/lsp/index.d.ts

@@ -1,6 +1,6 @@
 import { ChildProcess } from 'node:child_process';
 import { ProtocolConnection } from 'vscode-languageserver-protocol/node.js';
-import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, O as OutlineProvider, a as DiagnosticsProvider, F as FileAccessProvider, e as DiagnosticSeverity, C as CodeSnippet, d as Diagnostic$1, g as DocumentSymbol$1, j as ExactPosition, f as DiskRange, S as SymbolKind } from '../interfaces-wSmWeYxt.js';
+import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, O as OutlineProvider, a as DiagnosticsProvider, F as FileAccessProvider, g as DiagnosticSeverity, C as CodeSnippet, h as Diagnostic$1, i as DocumentSymbol$1, j as ExactPosition, k as DiskRange, S as SymbolKind } from '../interfaces-B9NK_71f.js';
 import { Location, LocationLink, Diagnostic, DocumentSymbol, SymbolInformation } from 'vscode-languageserver-protocol';
 
 interface LspClientOptions {

package/dist/mcp/index.d.ts

@@ -1,59 +1,8 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider, i as EditResult, l as FrontmatterMatch, o as GlobalFindMatch, L as Link } from '../interfaces-wSmWeYxt.js';
-import { R as ResolverConfig } from '../resolver-CSuvobsJ.js';
-
-/**
- * Zod schemas for MCP tool inputs and outputs.
- * @internal
- */
-
-declare const FuzzyPositionSchema: z.ZodObject<{
-    uri: z.ZodString;
-    symbol_name: z.ZodString;
-    line_hint: z.ZodNumber;
-    order_hint: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-declare const ApplyEditSchema: z.ZodObject<{
-    uri: z.ZodString;
-    start_hash: z.ZodString;
-    end_hash: z.ZodOptional<z.ZodString>;
-    replace_text: z.ZodString;
-    description: z.ZodString;
-}, z.core.$strip>;
-declare const CallHierarchySchema: z.ZodObject<{
-    uri: z.ZodString;
-    symbol_name: z.ZodString;
-    line_hint: z.ZodNumber;
-    order_hint: z.ZodDefault<z.ZodNumber>;
-    direction: z.ZodEnum<{
-        incoming: "incoming";
-        outgoing: "outgoing";
-    }>;
-}, z.core.$strip>;
-declare const GlobalFindSchema: z.ZodObject<{
-    query: z.ZodString;
-    case_sensitive: z.ZodDefault<z.ZodBoolean>;
-    exact_match: z.ZodDefault<z.ZodBoolean>;
-    regex_mode: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-declare const AddLinkSchema: z.ZodObject<{
-    path: z.ZodString;
-    pattern: z.ZodString;
-    link_to: z.ZodString;
-}, z.core.$strip>;
-declare const FileReferencesSchema: z.ZodObject<{
-    uri: z.ZodString;
-}, z.core.$strip>;
-declare const GetFrontmatterStructureSchema: z.ZodObject<{
-    property: z.ZodString;
-    path: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const SetFrontmatterSchema: z.ZodObject<{
-    path: z.ZodString;
-    property: z.ZodString;
-    value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodBoolean, z.ZodArray<z.ZodBoolean>, z.ZodNull]>;
-}, z.core.$strip>;
+import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider, d as EditResult, e as FrontmatterMatch, f as GlobalFindMatch, L as Link } from '../interfaces-B9NK_71f.js';
+import { ResolverConfig } from '../index.js';
+import { FuzzyPositionSchema, ApplyEditSchema, GetFrontmatterStructureSchema, SetFrontmatterSchema, GlobalFindSchema, AddLinkSchema, CallHierarchySchema, FileReferencesSchema } from '../schemas.js';
 
 /**
  * MCP entry point for installing individual providers onto an MCP server.

package/dist/pipe/index.d.ts

@@ -0,0 +1,43 @@
+import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider } from '../interfaces-B9NK_71f.js';
+
+interface connectPipeOptions {
+    pipeName: string;
+    connectTimeout?: number;
+}
+interface PipeConnection {
+    readonly fileAccess?: FileAccessProvider;
+    readonly edit?: EditProvider;
+    readonly definition?: DefinitionProvider;
+    readonly references?: ReferencesProvider;
+    readonly hierarchy?: HierarchyProvider;
+    readonly diagnostics?: DiagnosticsProvider;
+    readonly outline?: OutlineProvider;
+    readonly globalFind?: GlobalFindProvider;
+    readonly graph?: GraphProvider;
+    readonly frontmatter?: FrontmatterProvider;
+    readonly availableMethods: string[];
+    disconnect(): void;
+}
+declare function connectPipe(options: connectPipeOptions): Promise<PipeConnection>;
+
+interface servePipeOptions {
+    pipeName: string;
+    fileAccess: FileAccessProvider;
+    edit?: EditProvider;
+    definition?: DefinitionProvider;
+    references?: ReferencesProvider;
+    hierarchy?: HierarchyProvider;
+    diagnostics?: DiagnosticsProvider;
+    outline?: OutlineProvider;
+    globalFind?: GlobalFindProvider;
+    graph?: GraphProvider;
+    frontmatter?: FrontmatterProvider;
+}
+interface PipeServer {
+    readonly pipePath: string;
+    readonly connectionCount: number;
+    close(): Promise<void>;
+}
+declare function servePipe(options: servePipeOptions): Promise<PipeServer>;
+
+export { type PipeConnection, type PipeServer, connectPipe, type connectPipeOptions, servePipe, type servePipeOptions };

package/dist/pipe/index.js

@@ -0,0 +1,6 @@
+import {connect,createServer}from'net';import {unlinkSync}from'fs';var v=class{socket;requestHandler;notificationHandler;nextId=1;pending=new Map;buffer="";destroyed=false;constructor(e,r){this.socket=e,this.requestHandler=r?.onRequest,this.notificationHandler=r?.onNotification,e.on("data",n=>this.handleData(n)),e.on("close",()=>this.rejectAll(new Error("Connection closed"))),e.on("error",n=>this.rejectAll(n));}sendRequest(e,r){return this.destroyed?Promise.reject(new Error("Transport destroyed")):new Promise((n,f)=>{let o=this.nextId++;this.pending.set(o,{resolve:n,reject:f});let c={type:"request",id:o,method:e,params:r};this.socket.write(`${JSON.stringify(c)}
+`);})}sendNotification(e,r){if(this.destroyed)return;let n={type:"notification",method:e,params:r};this.socket.write(`${JSON.stringify(n)}
+`);}destroy(){this.destroyed||(this.destroyed=true,this.rejectAll(new Error("Transport destroyed")),this.socket.destroy());}handleData(e){this.buffer+=e.toString();let r=this.buffer.split(`
+`);this.buffer=r.pop()??"";for(let n of r){let f=n.replace(/\r$/,"");if(f)try{let o=JSON.parse(f);this.dispatch(o);}catch{}}}dispatch(e){switch(e.type){case "response":{let r=this.pending.get(e.id);r&&(this.pending.delete(e.id),e.error?r.reject(new Error(e.error.message)):r.resolve(e.result));break}case "request":{this.requestHandler&&this.requestHandler(e.method,e.params).then(r=>{if(this.destroyed)return;let n={type:"response",id:e.id,result:r};this.socket.write(`${JSON.stringify(n)}
+`);}).catch(r=>{if(this.destroyed)return;let n={type:"response",id:e.id,error:{message:r instanceof Error?r.message:String(r)}};this.socket.write(`${JSON.stringify(n)}
+`);});break}case "notification":{this.notificationHandler?.(e.method,e.params);break}}}rejectAll(e){for(let[,r]of this.pending)r.reject(e);this.pending.clear();}};function w(s){return process.platform==="win32"?`\\\\.\\pipe\\${s}`:`/tmp/${s}.sock`}var k=[{providerKey:"fileAccess",methods:["readFile","readDirectory"]},{providerKey:"edit",methods:["applyEdits","previewAndApplyEdits"]},{providerKey:"definition",methods:["provideDefinition"]},{providerKey:"references",methods:["provideReferences"]},{providerKey:"hierarchy",methods:["provideCallHierarchy"]},{providerKey:"diagnostics",methods:["provideDiagnostics","getWorkspaceDiagnostics"]},{providerKey:"outline",methods:["provideDocumentSymbols"]},{providerKey:"globalFind",methods:["globalFind"]},{providerKey:"graph",methods:["getLinkStructure","resolveOutlinks","resolveBacklinks","addLink"]},{providerKey:"frontmatter",methods:["getFrontmatterStructure","getFrontmatter","setFrontmatter"]}];function E(s){let{pipeName:e,connectTimeout:r=5e3}=s,n=w(e);return new Promise((f,o)=>{let c=connect(n),i=false,d=setTimeout(()=>{i||(i=true,c.destroy(),o(new Error(`Connection timeout after ${r}ms`)));},r);c.on("error",t=>{i||(i=true,clearTimeout(d),o(t));}),c.on("connect",()=>{if(clearTimeout(d),i)return;let t,l,a=new v(c,{onNotification:(h,P)=>{h==="onDiagnosticsChanged"&&t&&t(P[0]),h==="onFileChanged"&&l&&l(P[0]);}});a.sendRequest("_handshake",[]).then(h=>{if(i)return;let m=h.methods,p={};for(let{providerKey:g,methods:R}of k){let F=R.filter(u=>m.includes(`${g}.${u}`));if(F.length===0)continue;let y={};for(let u of F)y[u]=(...D)=>a.sendRequest(`${g}.${u}`,D);g==="diagnostics"&&m.includes("onDiagnosticsChanged")&&(y.onDiagnosticsChanged=u=>{t=u;}),g==="fileAccess"&&m.includes("onFileChanged")&&(y.onFileChanged=u=>{l=u;}),p[g]=y;}i=true,f({fileAccess:p.fileAccess,edit:p.edit,definition:p.definition,references:p.references,hierarchy:p.hierarchy,diagnostics:p.diagnostics,outline:p.outline,globalFind:p.globalFind,graph:p.graph,frontmatter:p.frontmatter,availableMethods:m,disconnect(){a.destroy();}});}).catch(h=>{i||(i=true,a.destroy(),o(h instanceof Error?h:new Error(String(h))));});});})}function S(s){let{pipeName:e}=s,r=w(e),n=new Map;for(let{providerKey:i,methods:d}of k){let t=s[i];if(t)for(let l of d){let a=t[l];if(typeof a=="function"){let h=`${i}.${l}`;n.set(h,(...P)=>a.apply(t,P));}}}let f=[...n.keys()];s.diagnostics?.onDiagnosticsChanged&&f.push("onDiagnosticsChanged"),s.fileAccess.onFileChanged&&f.push("onFileChanged");let o=new Set,c=createServer(i=>{let d=new v(i,{onRequest:async(t,l)=>{if(t==="_handshake")return {methods:f};let a=n.get(t);if(!a)throw new Error(`Unknown method: ${t}`);return a(...l)}});o.add(d),i.on("close",()=>o.delete(d));});return s.diagnostics?.onDiagnosticsChanged&&s.diagnostics.onDiagnosticsChanged(i=>{for(let d of o)d.sendNotification("onDiagnosticsChanged",[i]);}),s.fileAccess.onFileChanged&&s.fileAccess.onFileChanged(i=>{for(let d of o)d.sendNotification("onFileChanged",[i]);}),new Promise((i,d)=>{if(process.platform!=="win32")try{unlinkSync(r);}catch{}c.on("error",d),c.listen(r,()=>{c.removeListener("error",d),i({get pipePath(){return r},get connectionCount(){return o.size},async close(){for(let t of o)t.destroy();if(o.clear(),await new Promise((t,l)=>{c.close(a=>{a?l(a):t();});}),process.platform!=="win32")try{unlinkSync(r);}catch{}}});});})}export{E as connectPipe,S as servePipe};

package/dist/schemas.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+
+/**
+ * Zod schemas for MCP tool inputs and outputs.
+ */
+
+declare const FuzzyPositionSchema: z.ZodObject<{
+    uri: z.ZodString;
+    symbol_name: z.ZodString;
+    line_hint: z.ZodNumber;
+    order_hint: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ApplyEditSchema: z.ZodObject<{
+    uri: z.ZodString;
+    start_hash: z.ZodString;
+    end_hash: z.ZodOptional<z.ZodString>;
+    replace_text: z.ZodString;
+    description: z.ZodString;
+}, z.core.$strip>;
+declare const CallHierarchySchema: z.ZodObject<{
+    uri: z.ZodString;
+    symbol_name: z.ZodString;
+    line_hint: z.ZodNumber;
+    order_hint: z.ZodDefault<z.ZodNumber>;
+    direction: z.ZodEnum<{
+        incoming: "incoming";
+        outgoing: "outgoing";
+    }>;
+}, z.core.$strip>;
+declare const GlobalFindSchema: z.ZodObject<{
+    query: z.ZodString;
+    case_sensitive: z.ZodDefault<z.ZodBoolean>;
+    exact_match: z.ZodDefault<z.ZodBoolean>;
+    regex_mode: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const AddLinkSchema: z.ZodObject<{
+    path: z.ZodString;
+    pattern: z.ZodString;
+    link_to: z.ZodString;
+}, z.core.$strip>;
+declare const FileReferencesSchema: z.ZodObject<{
+    uri: z.ZodString;
+}, z.core.$strip>;
+declare const GetFrontmatterStructureSchema: z.ZodObject<{
+    property: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SetFrontmatterSchema: z.ZodObject<{
+    path: z.ZodString;
+    property: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNumber, z.ZodArray<z.ZodNumber>, z.ZodBoolean, z.ZodArray<z.ZodBoolean>, z.ZodNull]>;
+}, z.core.$strip>;
+
+export { AddLinkSchema, ApplyEditSchema, CallHierarchySchema, FileReferencesSchema, FuzzyPositionSchema, GetFrontmatterStructureSchema, GlobalFindSchema, SetFrontmatterSchema };

package/dist/schemas.js

@@ -0,0 +1,2 @@
+import {z}from'zod';var t=z.string().describe("The relative file path"),r=z.string().describe("The text of the symbol to find"),o=z.number().int().positive().describe("Approximate 1-based line number where the symbol is expected"),i=z.number().int().min(0).default(0).describe("0-based index of which occurrence to target if symbol appears multiple times"),l=z.object({uri:t,symbol_name:r,line_hint:o,order_hint:i}),d=z.object({uri:t,start_hash:z.string().describe('Start line reference from hashline output, format "<line>:<hash>" (e.g., "3:a1"). Copy this exactly from the files:// resource output.'),end_hash:z.string().optional().describe('End line reference for multi-line edits (e.g., "5:0e"). The range is inclusive. Omit for single-line edits (defaults to start_hash).'),replace_text:z.string().describe("The new text to replace the entire line range with"),description:z.string().describe("Rationale for the edit")}),p=z.object({uri:z.string().describe("The file URI or path"),symbol_name:r,line_hint:o,order_hint:i,direction:z.enum(["incoming","outgoing"]).describe("Direction of the call hierarchy")}),n=z.string().describe("The search query"),s=z.boolean().default(false).describe("Whether the search is case-sensitive"),a=z.boolean().default(false).describe("Whether to match exact words only"),c=z.boolean().default(false).describe("Whether the query is a regular expression"),b=z.object({query:n,case_sensitive:s,exact_match:a,regex_mode:c}),m=z.object({path:z.string().describe("The path to the document to modify"),pattern:z.string().describe("The text pattern to find and replace with a link"),link_to:z.string().describe("The target URI the link should point to")}),u=z.object({uri:t}),f=z.object({property:z.string().describe("The frontmatter property name to search for"),path:z.string().optional().describe("Optional path to limit the search to a specific document. If not provided, searches all documents.")}),g=z.object({path:z.string().describe("The path to the document to modify"),property:z.string().describe("The frontmatter property name to set"),value:z.union([z.string(),z.array(z.string()),z.number(),z.array(z.number()),z.boolean(),z.array(z.boolean()),z.null()]).describe("The value to set. Can be a string, number, boolean, array of these types, or null to remove.")});
+export{m as AddLinkSchema,d as ApplyEditSchema,p as CallHierarchySchema,u as FileReferencesSchema,l as FuzzyPositionSchema,f as GetFrontmatterStructureSchema,b as GlobalFindSchema,g as SetFrontmatterSchema};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opticlm/connector",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "Provides an abstract interface that allows LLMs to connect to fact sources such as LSPs, code diagnostics, symbol definitions/references, links, and frontmatter",
   "type": "module",
   "types": "dist/index.d.ts",
@@ -16,6 +16,14 @@
     "./mcp": {
       "types": "./dist/mcp/index.d.ts",
       "default": "./dist/mcp/index.js"
+    },
+    "./pipe": {
+      "types": "./dist/pipe/index.d.ts",
+      "default": "./dist/pipe/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "default": "./dist/schemas.js"
     }
   },
   "files": [

package/dist/resolver-CSuvobsJ.d.ts

@@ -1,69 +0,0 @@
-import { F as FileAccessProvider, U as UnifiedUri, n as FuzzyPosition, j as ExactPosition } from './interfaces-wSmWeYxt.js';
-
-/**
- * Smart Resolver Logic for MCP LSP Driver SDK
- *
- * This is the internal engine of the SDK. It translates the LLM's imprecise
- * instructions into precise coordinates.
- */
-
-/**
- * Configuration options for the SymbolResolver.
- */
-interface ResolverConfig {
-    /**
-     * Number of lines to scan above and below the lineHint if the symbol
-     * is not found at the exact line. Defaults to 2.
-     */
-    lineSearchRadius?: number;
-}
-/**
- * Error thrown when a symbol cannot be resolved.
- */
-declare class SymbolResolutionError extends Error {
-    readonly symbolName: string;
-    readonly lineHint: number;
-    readonly reason: string;
-    constructor(symbolName: string, lineHint: number, reason: string);
-}
-/**
- * The SymbolResolver translates fuzzy positions (as provided by an LLM)
- * into exact positions that can be used by the IDE.
- *
- * Algorithm:
- * 1. Read file content via FileAccessProvider.
- * 2. Split content into lines.
- * 3. Target the lineHint (converting 1-based to 0-based).
- * 4. Search for symbolName in that line.
- *    - If orderHint is 0, find first occurrence.
- *    - If orderHint is N, find Nth occurrence.
- * 5. Robustness Fallback:
- *    - If the line is empty or symbol not found at lineHint,
- *      scan +/- lineSearchRadius lines to handle minor line shifts.
- * 6. Return ExactPosition (line, character start index).
- */
-declare class SymbolResolver {
-    private readonly fs;
-    private readonly lineSearchRadius;
-    constructor(fs: FileAccessProvider, config?: ResolverConfig);
-    /**
-     * Resolves a fuzzy position to an exact position.
-     *
-     * @param uri - The URI of the file
-     * @param fuzzy - The fuzzy position provided by the LLM
-     * @returns The exact position in the file
-     * @throws SymbolResolutionError if the symbol cannot be found
-     */
-    resolvePosition(uri: UnifiedUri, fuzzy: FuzzyPosition): Promise<ExactPosition>;
-    /**
-     * Finds the Nth occurrence of a symbol in a line.
-     *
-     * @param line - The line to search in (may be undefined if out of bounds)
-     * @param symbolName - The symbol to find
-     * @param orderHint - Which occurrence to find (0-based)
-     * @returns The character offset of the symbol, or null if not found
-     */
-    private findSymbolInLine;
-}
-
-export { type ResolverConfig as R, SymbolResolutionError as S, SymbolResolver as a };