@octocodeai/octocode-engine 16.5.1 → 16.6.2

package/index.cjs

@@ -75,13 +75,38 @@ function loadNativeBinding() {
     join(__dirname, '..', '..', 'runtime', 'engine', `${binaryName}.${key}.node`),
   ]
 
+  const loadErrors = []
   for (const candidate of candidates) {
     if (existsSync(candidate)) {
-      return require(candidate)
+      try {
+        return require(candidate)
+      } catch (err) {
+        // The .node file exists but the host refused to load it — most often a
+        // hardened/sandboxed runtime (e.g. an editor/app-embedded Node) that
+        // blocks native addons, or an ABI/arch mismatch. Distinguish this from
+        // "binary missing" so callers don't report a generic tool failure.
+        loadErrors.push(`${candidate}: ${err && err.message ? err.message : err}`)
+      }
     }
   }
 
-  return require(`${packageName}-${key}`)
+  try {
+    return require(`${packageName}-${key}`)
+  } catch (err) {
+    loadErrors.push(`${packageName}-${key}: ${err && err.message ? err.message : err}`)
+  }
+
+  const detail = loadErrors.length
+    ? `\nNative load attempts:\n  - ${loadErrors.join('\n  - ')}`
+    : `\nNo native binary found for ${key} (looked in ${candidates.length} locations and the ${packageName}-${key} package).`
+  const error = new Error(
+    `@octocodeai/octocode-engine: could not load the native ${binaryName} addon for ${key}.` +
+      detail +
+      `\nIf a .node file exists above but failed to load, the current Node runtime is likely sandboxed and rejects ` +
+      `native addons (e.g. an editor/app-embedded Node). Re-run with system Node (\`which node\`).`
+  )
+  error.code = 'OCTOCODE_ENGINE_NATIVE_LOAD_FAILED'
+  throw error
 }
 
 const nativeBinding = loadNativeBinding()
@@ -90,6 +115,11 @@ nativeBinding.MINIFY_CONFIG = nativeBinding.getMINIFY_CONFIG()
 nativeBinding.SUPPORTED_SIGNATURE_EXTENSIONS = Object.freeze(
   nativeBinding.getSupportedSignatureExtensions().sort()
 )
+nativeBinding.SUPPORTED_GRAPH_FACT_EXTENSIONS = Object.freeze(
+  typeof nativeBinding.getSupportedGraphFactExtensions === 'function'
+    ? nativeBinding.getSupportedGraphFactExtensions().sort()
+    : []
+)
 nativeBinding.SUPPORTED_STRUCTURAL_EXTENSIONS = Object.freeze(
   nativeBinding.getSupportedStructuralExtensions().sort()
 )

package/index.d.ts

@@ -6,6 +6,8 @@ export declare class NativeLspClient {
   stop(): Promise<void>
   waitForReady(timeoutMs?: number | undefined | null): Promise<void>
   hasCapability(capability: string): boolean
+  /** Server-selected LSP `positionEncoding` (utf-16 unless the server is non-conformant); null if omitted/not started. */
+  positionEncoding(): string | null
   getRecentStderr(): Array<string>
   openDocument(filePath: string, content: string): Promise<void>
   closeDocument(filePath: string): Promise<void>
@@ -18,6 +20,16 @@ export declare class NativeLspClient {
   prepareCallHierarchy(filePath: string, line: number, character: number): Promise<any>
   incomingCalls(item: any): Promise<any>
   outgoingCalls(item: any): Promise<any>
+  /** Project-wide fuzzy symbol search — `workspace/symbol`. Returns `WorkspaceSymbol[] | SymbolInformation[]`. */
+  workspaceSymbol(query: string): Promise<any>
+  /** Prepare a type-hierarchy item at a position — `textDocument/prepareTypeHierarchy`. */
+  prepareTypeHierarchy(filePath: string, line: number, character: number): Promise<any>
+  /** Supertypes (base classes / implemented interfaces) — `typeHierarchy/supertypes`. */
+  typeHierarchySupertypes(item: any): Promise<any>
+  /** Subtypes (subclasses / implementors) — `typeHierarchy/subtypes`. */
+  typeHierarchySubtypes(item: any): Promise<any>
+  /** Pull diagnostics for a single file — `textDocument/diagnostic` (LSP 3.17+). */
+  getDiagnostics(filePath: string): Promise<any>
 }
 
 /**
@@ -206,6 +218,94 @@ export declare function extractJsSymbols(content: string, filePath: string): str
  */
 export declare function findInFileReferences(content: string, filePath: string, line: number, character: number): string | null
 
+export interface GraphFactPosition {
+  line: number
+  character: number
+}
+
+export interface GraphFactRange {
+  start: GraphFactPosition
+  end: GraphFactPosition
+}
+
+export interface GraphFactDeclaration {
+  id: string
+  name: string
+  kind: string
+  line: number
+  range: GraphFactRange
+  selectionRange: GraphFactRange
+  exported: boolean
+  parent?: string
+}
+
+export interface GraphFactImport {
+  id: string
+  specifier: string
+  line: number
+  importKind: string
+  localName?: string
+  importedName?: string
+}
+
+export interface GraphFactExport {
+  id: string
+  name: string
+  line: number
+  exportKind: string
+  localName?: string
+  source?: string
+}
+
+export interface GraphFactCall {
+  id: string
+  caller: string
+  callee: string
+  line: number
+  range: GraphFactRange
+  kind: string
+}
+
+export interface GraphFactEdge {
+  id: string
+  from: string
+  to: string
+  relation: string
+  source: string
+  line: number
+}
+
+export interface GraphFacts {
+  kind: 'graphFacts'
+  source: 'native-ast'
+  language: string
+  file: string
+  declarations: Array<GraphFactDeclaration>
+  imports: Array<GraphFactImport>
+  exports: Array<GraphFactExport>
+  calls: Array<GraphFactCall>
+  edges: Array<GraphFactEdge>
+  diagnostics: Array<string>
+}
+
+export interface GraphFactCapability {
+  extension: string
+  language: string
+  languageId?: string
+  structuralSearch: boolean
+  signatureOutline: boolean
+  graphFacts: boolean
+  factFamilies: Array<string>
+}
+
+/**
+ * Native graph facts as a JSON `GraphFacts` object, or null when no graph-fact
+ * extractor supports the file. JS/TS use the richer OXC lane; other supported
+ * source languages use tree-sitter syntax inventory. Cross-file semantic
+ * identity still needs LSP proof.
+ */
+export declare function extractGraphFacts(content: string, filePath: string): string | null
+
 /**
  * Canonical list of file extensions (lowercase, no leading dot) handled by the
  * native oxc JS/TS path (`extractJsSymbols` / `findInFileReferences`). Gate
@@ -213,6 +313,18 @@ export declare function findInFileReferences(content: string, filePath: string,
  */
 export declare function getSupportedJsTsExtensions(): Array<string>
 
+/**
+ * Canonical list of file extensions (lowercase, no leading dot) that can emit
+ * native graph facts. JS/TS use OXC; other entries use tree-sitter syntax
+ * inventory.
+ */
+export declare function getSupportedGraphFactExtensions(): Array<string>
+
+/**
+ * JSON `GraphFactCapability[]` describing graph-fact coverage by extension.
+ */
+export declare function getGraphFactCapabilities(): string
+
 export interface FileSystemEntry {
   /** Absolute or input-root-relative path as returned by the platform. */
   path: string
@@ -362,6 +474,7 @@ export interface MinifyConfigSnapshot {
 
 export declare const MINIFY_CONFIG: MinifyConfigSnapshot
 export declare const SUPPORTED_SIGNATURE_EXTENSIONS: readonly string[]
+export declare const SUPPORTED_GRAPH_FACT_EXTENSIONS: readonly string[]
 export declare const SUPPORTED_STRUCTURAL_EXTENSIONS: readonly string[]
 
 /**

package/index.js

@@ -32,7 +32,10 @@ export const stripPythonDocstrings = nativeBinding.stripPythonDocstrings
 export const extractSignatures = nativeBinding.extractSignatures
 export const extractJsSymbols = nativeBinding.extractJsSymbols
 export const findInFileReferences = nativeBinding.findInFileReferences
+export const extractGraphFacts = nativeBinding.extractGraphFacts
 export const getSupportedJsTsExtensions = nativeBinding.getSupportedJsTsExtensions
+export const getSupportedGraphFactExtensions = nativeBinding.getSupportedGraphFactExtensions
+export const getGraphFactCapabilities = nativeBinding.getGraphFactCapabilities
 export const structuralSearch = nativeBinding.structuralSearch
 export const structuralSearchDetailed = nativeBinding.structuralSearchDetailed
 export const structuralSearchFiles = nativeBinding.structuralSearchFiles
@@ -44,6 +47,7 @@ export const jsonToYamlString = nativeBinding.jsonToYamlString
 export const getMINIFY_CONFIG = nativeBinding.getMINIFY_CONFIG
 export const MINIFY_CONFIG = nativeBinding.MINIFY_CONFIG
 export const SUPPORTED_SIGNATURE_EXTENSIONS = nativeBinding.SUPPORTED_SIGNATURE_EXTENSIONS
+export const SUPPORTED_GRAPH_FACT_EXTENSIONS = nativeBinding.SUPPORTED_GRAPH_FACT_EXTENSIONS
 export const SUPPORTED_STRUCTURAL_EXTENSIONS = nativeBinding.SUPPORTED_STRUCTURAL_EXTENSIONS
 export const parseRipgrepJson = nativeBinding.parseRipgrepJson
 export const searchRipgrep = nativeBinding.searchRipgrep
@@ -55,6 +59,7 @@ export const byteSliceContent = nativeBinding.byteSliceContent
 export const sliceContent = nativeBinding.sliceContent
 export const extractMatchingLines = nativeBinding.extractMatchingLines
 export const filterPatch = nativeBinding.filterPatch
+export const PatchLineType = nativeBinding.PatchLineType
 export const inspectBinaryNative = nativeBinding.inspectBinaryNative
 export const extractBinaryStringsNative = nativeBinding.extractBinaryStringsNative
 export const NativeLspClient = nativeBinding.NativeLspClient

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@octocodeai/octocode-engine",
-  "version": "16.5.1",
+  "version": "16.6.2",
   "description": "Rust native Octocode engine for context compression, structural search, and LSP semantic navigation",
   "type": "module",
   "main": "index.cjs",
   "types": "index.d.ts",
   "license": "MIT",
   "author": "Guy Bary <bgauryy@octocodeai.com>",
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/bgauryy/octocode-mcp.git",
@@ -109,6 +112,26 @@
       "import": "./dist/lsp/manager.js",
       "default": "./dist/lsp/manager.js"
     },
+    "./lsp/platform": {
+      "types": "./dist/lsp/platform.d.ts",
+      "import": "./dist/lsp/platform.js",
+      "default": "./dist/lsp/platform.js"
+    },
+    "./lsp/serverDiscovery": {
+      "types": "./dist/lsp/serverDiscovery.d.ts",
+      "import": "./dist/lsp/serverDiscovery.js",
+      "default": "./dist/lsp/serverDiscovery.js"
+    },
+    "./lsp/serverManifest": {
+      "types": "./dist/lsp/serverManifest.d.ts",
+      "import": "./dist/lsp/serverManifest.js",
+      "default": "./dist/lsp/serverManifest.js"
+    },
+    "./lsp/serverProvisioner": {
+      "types": "./dist/lsp/serverProvisioner.d.ts",
+      "import": "./dist/lsp/serverProvisioner.js",
+      "default": "./dist/lsp/serverProvisioner.js"
+    },
     "./lsp/resolver": {
       "types": "./dist/lsp/resolver.d.ts",
       "import": "./dist/lsp/resolver.js",
@@ -196,6 +219,18 @@
       "lsp/manager": [
         "./dist/lsp/manager.d.ts"
       ],
+      "lsp/platform": [
+        "./dist/lsp/platform.d.ts"
+      ],
+      "lsp/serverDiscovery": [
+        "./dist/lsp/serverDiscovery.d.ts"
+      ],
+      "lsp/serverManifest": [
+        "./dist/lsp/serverManifest.d.ts"
+      ],
+      "lsp/serverProvisioner": [
+        "./dist/lsp/serverProvisioner.d.ts"
+      ],
       "lsp/resolver": [
         "./dist/lsp/resolver.d.ts"
       ],
@@ -227,12 +262,12 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "@octocodeai/octocode-engine-darwin-arm64": "16.5.1",
-    "@octocodeai/octocode-engine-darwin-x64": "16.5.1",
-    "@octocodeai/octocode-engine-linux-arm64-gnu": "16.5.1",
-    "@octocodeai/octocode-engine-linux-x64-gnu": "16.5.1",
-    "@octocodeai/octocode-engine-linux-x64-musl": "16.5.1",
-    "@octocodeai/octocode-engine-win32-x64-msvc": "16.5.1"
+    "@octocodeai/octocode-engine-darwin-arm64": "16.6.2",
+    "@octocodeai/octocode-engine-darwin-x64": "16.6.2",
+    "@octocodeai/octocode-engine-linux-arm64-gnu": "16.6.2",
+    "@octocodeai/octocode-engine-linux-x64-gnu": "16.6.2",
+    "@octocodeai/octocode-engine-linux-x64-musl": "16.6.2",
+    "@octocodeai/octocode-engine-win32-x64-msvc": "16.6.2"
   },
   "engines": {
     "node": ">=20.0.0"
@@ -256,10 +291,11 @@
     "build:linux-x64-musl": "node scripts/prebuild.cjs && napi build --platform --release --cross-compile --target x86_64-unknown-linux-musl && node scripts/postbuild.cjs",
     "build:linux-arm64-gnu": "node scripts/prebuild.cjs && napi build --platform --release --cross-compile --target aarch64-unknown-linux-gnu && node scripts/postbuild.cjs",
     "build:windows-x64": "node scripts/prebuild.cjs && napi build --platform --release --cross-compile --target x86_64-pc-windows-msvc && node scripts/postbuild.cjs",
-    "build:all": "yarn build:darwin-arm64 && yarn build:darwin-x64 && yarn build:linux-x64-gnu && yarn build:linux-x64-musl && yarn build:linux-arm64-gnu && yarn build:windows-x64 && yarn build:ts",
+    "build:all": "yarn clean:binaries && yarn build:darwin-arm64 && yarn build:darwin-x64 && yarn build:linux-x64-gnu && yarn build:linux-x64-musl && yarn build:linux-arm64-gnu && yarn build:windows-x64 && yarn build:ts",
     "build:dev": "yarn readme:sync && node scripts/prebuild.cjs && napi build --platform && node scripts/postbuild.cjs && tsc -p tsconfig.build.json",
     "build:ts": "yarn readme:sync && rm -rf dist && tsc -p tsconfig.build.json",
     "clean": "rm -rf dist/ && rm -f *.node",
+    "clean:binaries": "rm -f *.node && find npm -name '*.node' -delete",
     "gen": "node scripts/gen-patterns.mjs",
     "verify:patterns": "node scripts/gen-patterns.mjs && git diff --exit-code src/security/patterns.rs || (echo 'ERROR: src/security/patterns.rs is out of sync with the TS source — run yarn gen and commit the result' && exit 1)",
     "pack:check": "node scripts/check-pack-size.cjs",
@@ -302,8 +338,13 @@
     "prepublishOnly": "yarn version:sync"
   },
   "dependencies": {
+    "bash-language-server": "^5.6.0",
+    "intelephense": "^1.14.1",
+    "pyright": "^1.1.411",
     "typescript": "^5.9.3",
     "typescript-language-server": "^4.4.0",
+    "vscode-langservers-extracted": "^4.10.0",
+    "yaml-language-server": "^1.23.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {