mcp-garry-codes 1.0.0

package/dist/contracts/test_contracts.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+export declare const RunGLuaTestInputSchema: z.ZodEffects<z.ZodObject<{
+    test_file_path: z.ZodOptional<z.ZodString>;
+    code_to_test: z.ZodOptional<z.ZodString>;
+    mock_realm: z.ZodDefault<z.ZodEnum<["client", "server", "shared"]>>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mock_realm: "server" | "client" | "shared";
+    timeout_ms: number;
+    test_file_path?: string | undefined;
+    code_to_test?: string | undefined;
+}, {
+    test_file_path?: string | undefined;
+    code_to_test?: string | undefined;
+    mock_realm?: "server" | "client" | "shared" | undefined;
+    timeout_ms?: number | undefined;
+}>, {
+    mock_realm: "server" | "client" | "shared";
+    timeout_ms: number;
+    test_file_path?: string | undefined;
+    code_to_test?: string | undefined;
+}, {
+    test_file_path?: string | undefined;
+    code_to_test?: string | undefined;
+    mock_realm?: "server" | "client" | "shared" | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type RunGLuaTestInput = z.infer<typeof RunGLuaTestInputSchema>;
+export interface GLuaTestError {
+    test_name: string;
+    error_message: string;
+    stack_trace: string;
+}
+export interface RunGLuaTestOutput {
+    passed: boolean;
+    tests_run: number;
+    failures: number;
+    errors: GLuaTestError[];
+    output_log: string;
+    execution_time_ms: number;
+}
+//# sourceMappingURL=test_contracts.d.ts.map

package/dist/contracts/test_contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_contracts.d.ts","sourceRoot":"","sources":["../../src/contracts/test_contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/contracts/test_contracts.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export const RunGLuaTestInputSchema = z.object({
+    test_file_path: z.string().optional().describe("Workspace path to test script (Lua or Python)"),
+    code_to_test: z.string().optional().describe("Inline GLua test code with assertions"),
+    mock_realm: z.enum(["client", "server", "shared"]).default("shared").describe("Mock simulation realm"),
+    timeout_ms: z.number().int().min(500).max(30000).default(5000).describe("Maximum execution timeout in milliseconds")
+}).refine(data => data.test_file_path || data.code_to_test, {
+    message: "Either test_file_path or code_to_test must be provided."
+});
+//# sourceMappingURL=test_contracts.js.map

package/dist/contracts/test_contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_contracts.js","sourceRoot":"","sources":["../../src/contracts/test_contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC/F,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACrF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACtG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CACrH,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,YAAY,EAAE;IAC1D,OAAO,EAAE,yDAAyD;CACnE,CAAC,CAAC"}

package/dist/contracts/wiki_contracts.d.ts

@@ -0,0 +1,96 @@
+import { z } from "zod";
+export declare const SearchGModWikiInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    category: z.ZodDefault<z.ZodEnum<["functions", "hooks", "libraries", "panels", "enums", "all"]>>;
+    realm: z.ZodDefault<z.ZodEnum<["server", "client", "shared", "menu", "all"]>>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    category: "functions" | "hooks" | "libraries" | "panels" | "enums" | "all";
+    realm: "all" | "server" | "client" | "shared" | "menu";
+    max_results: number;
+}, {
+    query: string;
+    category?: "functions" | "hooks" | "libraries" | "panels" | "enums" | "all" | undefined;
+    realm?: "all" | "server" | "client" | "shared" | "menu" | undefined;
+    max_results?: number | undefined;
+}>;
+export type SearchGModWikiInput = z.infer<typeof SearchGModWikiInputSchema>;
+export interface WikiSearchResultItem {
+    title: string;
+    url: string;
+    realm: "server" | "client" | "shared" | "menu";
+    summary: string;
+    signature: string;
+    category: string;
+}
+export interface SearchGModWikiOutput {
+    query: string;
+    category: string;
+    realm: string;
+    total_matches: number;
+    results: WikiSearchResultItem[];
+}
+export declare const GetGModSymbolInputSchema: z.ZodObject<{
+    symbol: z.ZodString;
+    include_examples: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    symbol: string;
+    include_examples: boolean;
+}, {
+    symbol: string;
+    include_examples?: boolean | undefined;
+}>;
+export type GetGModSymbolInput = z.infer<typeof GetGModSymbolInputSchema>;
+export interface SymbolArgument {
+    name: string;
+    type: string;
+    optional: boolean;
+    default?: string;
+    description: string;
+}
+export interface SymbolReturn {
+    name: string;
+    type: string;
+    description: string;
+}
+export interface SymbolExample {
+    title: string;
+    code: string;
+}
+export interface GetGModSymbolOutput {
+    symbol: string;
+    realm: "server" | "client" | "shared" | "menu";
+    description: string;
+    arguments: SymbolArgument[];
+    returns: SymbolReturn[];
+    examples: SymbolExample[];
+    notes: string[];
+    warnings: string[];
+    wiki_url: string;
+}
+export declare const WebSearchGLuaInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    domain_filter: z.ZodDefault<z.ZodEnum<["github", "facepunch", "reddit", "steam", "all"]>>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    max_results: number;
+    domain_filter: "all" | "github" | "facepunch" | "reddit" | "steam";
+}, {
+    query: string;
+    max_results?: number | undefined;
+    domain_filter?: "all" | "github" | "facepunch" | "reddit" | "steam" | undefined;
+}>;
+export type WebSearchGLuaInput = z.infer<typeof WebSearchGLuaInputSchema>;
+export interface WebSearchResultItem {
+    title: string;
+    url: string;
+    snippet: string;
+    source: string;
+}
+export interface WebSearchGLuaOutput {
+    query: string;
+    results: WebSearchResultItem[];
+}
+//# sourceMappingURL=wiki_contracts.d.ts.map

package/dist/contracts/wiki_contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_contracts.d.ts","sourceRoot":"","sources":["../../src/contracts/wiki_contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC"}

package/dist/contracts/wiki_contracts.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export const SearchGModWikiInputSchema = z.object({
+    query: z.string().min(1).describe("Search term (e.g. 'net.Receive', 'GM:PlayerInitialSpawn', 'DScrollPanel')"),
+    category: z.enum(["functions", "hooks", "libraries", "panels", "enums", "all"]).default("all").describe("Filter search by category"),
+    realm: z.enum(["server", "client", "shared", "menu", "all"]).default("all").describe("Filter by Garry's Mod execution realm"),
+    max_results: z.number().int().min(1).max(20).default(5).describe("Maximum number of results to return (1-20)")
+});
+export const GetGModSymbolInputSchema = z.object({
+    symbol: z.string().min(1).describe("Exact symbol name (e.g. 'surface.DrawPoly', 'Entity:TakeDamage', 'GM:CalcView')"),
+    include_examples: z.boolean().default(true).describe("Include official usage examples if available")
+});
+export const WebSearchGLuaInputSchema = z.object({
+    query: z.string().min(1).describe("Search query for community solutions, GitHub code, or GMod forums"),
+    domain_filter: z.enum(["github", "facepunch", "reddit", "steam", "all"]).default("all").describe("Target community platform"),
+    max_results: z.number().int().min(1).max(10).default(5).describe("Maximum number of search results (1-10)")
+});
+//# sourceMappingURL=wiki_contracts.js.map

package/dist/contracts/wiki_contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_contracts.js","sourceRoot":"","sources":["../../src/contracts/wiki_contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2EAA2E,CAAC;IAC9G,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACpI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC7H,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC/G,CAAC,CAAC;AAqBH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iFAAiF,CAAC;IACrH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACrG,CAAC,CAAC;AAmCH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACtG,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC7H,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CAC5G,CAAC,CAAC"}

package/dist/core/cache.d.ts

@@ -0,0 +1,9 @@
+export declare class TTLCache {
+    private memoryCache;
+    private diskCacheDir?;
+    constructor(diskCacheDir?: string);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttlMs: number): Promise<void>;
+    private sanitizeKey;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AASA,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,YAAY,CAAC,EAAE,MAAM;IAIpB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA6BtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE,OAAO,CAAC,WAAW;CAGpB"}

package/dist/core/cache.js

@@ -0,0 +1,56 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { logger } from "./logger.js";
+export class TTLCache {
+    memoryCache = new Map();
+    diskCacheDir;
+    constructor(diskCacheDir) {
+        this.diskCacheDir = diskCacheDir;
+    }
+    async get(key) {
+        const now = Date.now();
+        const mem = this.memoryCache.get(key);
+        if (mem) {
+            if (mem.expiresAt > now) {
+                return mem.value;
+            }
+            this.memoryCache.delete(key);
+        }
+        if (this.diskCacheDir) {
+            try {
+                const filePath = path.join(this.diskCacheDir, `${this.sanitizeKey(key)}.json`);
+                const data = await fs.readFile(filePath, "utf-8");
+                const entry = JSON.parse(data);
+                if (entry.expiresAt > now) {
+                    // Re-populate memory
+                    this.memoryCache.set(key, entry);
+                    return entry.value;
+                }
+                await fs.unlink(filePath).catch(() => { });
+            }
+            catch {
+                // Disk cache miss or read error
+            }
+        }
+        return null;
+    }
+    async set(key, value, ttlMs) {
+        const expiresAt = Date.now() + ttlMs;
+        const entry = { value, expiresAt };
+        this.memoryCache.set(key, entry);
+        if (this.diskCacheDir) {
+            try {
+                await fs.mkdir(this.diskCacheDir, { recursive: true });
+                const filePath = path.join(this.diskCacheDir, `${this.sanitizeKey(key)}.json`);
+                await fs.writeFile(filePath, JSON.stringify(entry), "utf-8");
+            }
+            catch (err) {
+                logger.warn(`Failed to write disk cache for key '${key}':`, { error: String(err) });
+            }
+        }
+    }
+    sanitizeKey(key) {
+        return key.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Standardized Error Codes and Error Hierarchy for mcp-garry-codes.
+ */
+export declare enum GModErrorCode {
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    SCHEMA_VALIDATION_FAILED = "SCHEMA_VALIDATION_FAILED",
+    PATH_JAIL_VIOLATION = "PATH_JAIL_VIOLATION",
+    COMMAND_INJECTION_DETECTED = "COMMAND_INJECTION_DETECTED",
+    UNSAFE_OPERATION = "UNSAFE_OPERATION",
+    CREDENTIAL_EXPOSURE_RISK = "CREDENTIAL_EXPOSURE_RISK",
+    REALM_MISMATCH = "REALM_MISMATCH",
+    NETWORK_STRING_UNREGISTERED = "NETWORK_STRING_UNREGISTERED",
+    NET_MESSAGE_OVERFLOW = "NET_MESSAGE_OVERFLOW",
+    SYNTAX_ERROR = "SYNTAX_ERROR",
+    PARSER_FAILURE = "PARSER_FAILURE",
+    PROCESS_TIMEOUT = "PROCESS_TIMEOUT",
+    PROCESS_EXECUTION_FAILED = "PROCESS_EXECUTION_FAILED",
+    TOOL_NOT_FOUND = "TOOL_NOT_FOUND",
+    WIKI_FETCH_ERROR = "WIKI_FETCH_ERROR",
+    SYMBOL_NOT_FOUND = "SYMBOL_NOT_FOUND",
+    CACHE_ERROR = "CACHE_ERROR",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+export interface GModErrorDetails {
+    code: GModErrorCode;
+    message: string;
+    remediation?: string;
+    context?: Record<string, unknown>;
+}
+export declare class GModMCPError extends Error {
+    readonly code: GModErrorCode;
+    readonly remediation?: string;
+    readonly context?: Record<string, unknown>;
+    constructor(details: GModErrorDetails);
+    toJSON(): GModErrorDetails;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,aAAa;IAEvB,gBAAgB,qBAAqB;IACrC,wBAAwB,6BAA6B;IAGrD,mBAAmB,wBAAwB;IAC3C,0BAA0B,+BAA+B;IACzD,gBAAgB,qBAAqB;IACrC,wBAAwB,6BAA6B;IAGrD,cAAc,mBAAmB;IACjC,2BAA2B,gCAAgC;IAC3D,oBAAoB,yBAAyB;IAC7C,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;IAGjC,eAAe,oBAAoB;IACnC,wBAAwB,6BAA6B;IACrD,cAAc,mBAAmB;IAGjC,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAG3B,cAAc,mBAAmB;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,aAAa,CAAC;IACpC,SAAgB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,OAAO,EAAE,gBAAgB;IAS9B,MAAM,IAAI,gBAAgB;CAQlC"}

package/dist/core/errors.js

@@ -0,0 +1,52 @@
+/**
+ * Standardized Error Codes and Error Hierarchy for mcp-garry-codes.
+ */
+export var GModErrorCode;
+(function (GModErrorCode) {
+    // Input & Contract Errors
+    GModErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    GModErrorCode["SCHEMA_VALIDATION_FAILED"] = "SCHEMA_VALIDATION_FAILED";
+    // Security & Boundary Errors
+    GModErrorCode["PATH_JAIL_VIOLATION"] = "PATH_JAIL_VIOLATION";
+    GModErrorCode["COMMAND_INJECTION_DETECTED"] = "COMMAND_INJECTION_DETECTED";
+    GModErrorCode["UNSAFE_OPERATION"] = "UNSAFE_OPERATION";
+    GModErrorCode["CREDENTIAL_EXPOSURE_RISK"] = "CREDENTIAL_EXPOSURE_RISK";
+    // Garry's Mod Domain Errors
+    GModErrorCode["REALM_MISMATCH"] = "REALM_MISMATCH";
+    GModErrorCode["NETWORK_STRING_UNREGISTERED"] = "NETWORK_STRING_UNREGISTERED";
+    GModErrorCode["NET_MESSAGE_OVERFLOW"] = "NET_MESSAGE_OVERFLOW";
+    GModErrorCode["SYNTAX_ERROR"] = "SYNTAX_ERROR";
+    GModErrorCode["PARSER_FAILURE"] = "PARSER_FAILURE";
+    // Process & Subsystem Execution
+    GModErrorCode["PROCESS_TIMEOUT"] = "PROCESS_TIMEOUT";
+    GModErrorCode["PROCESS_EXECUTION_FAILED"] = "PROCESS_EXECUTION_FAILED";
+    GModErrorCode["TOOL_NOT_FOUND"] = "TOOL_NOT_FOUND";
+    // Wiki & Search
+    GModErrorCode["WIKI_FETCH_ERROR"] = "WIKI_FETCH_ERROR";
+    GModErrorCode["SYMBOL_NOT_FOUND"] = "SYMBOL_NOT_FOUND";
+    GModErrorCode["CACHE_ERROR"] = "CACHE_ERROR";
+    // General Internal
+    GModErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(GModErrorCode || (GModErrorCode = {}));
+export class GModMCPError extends Error {
+    code;
+    remediation;
+    context;
+    constructor(details) {
+        super(`[${details.code}] ${details.message}`);
+        this.name = "GModMCPError";
+        this.code = details.code;
+        this.remediation = details.remediation;
+        this.context = details.context;
+        Object.setPrototypeOf(this, GModMCPError.prototype);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            remediation: this.remediation,
+            context: this.context
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,aA8BX;AA9BD,WAAY,aAAa;IACvB,0BAA0B;IAC1B,sDAAqC,CAAA;IACrC,sEAAqD,CAAA;IAErD,6BAA6B;IAC7B,4DAA2C,CAAA;IAC3C,0EAAyD,CAAA;IACzD,sDAAqC,CAAA;IACrC,sEAAqD,CAAA;IAErD,4BAA4B;IAC5B,kDAAiC,CAAA;IACjC,4EAA2D,CAAA;IAC3D,8DAA6C,CAAA;IAC7C,8CAA6B,CAAA;IAC7B,kDAAiC,CAAA;IAEjC,gCAAgC;IAChC,oDAAmC,CAAA;IACnC,sEAAqD,CAAA;IACrD,kDAAiC,CAAA;IAEjC,gBAAgB;IAChB,sDAAqC,CAAA;IACrC,sDAAqC,CAAA;IACrC,4CAA2B,CAAA;IAE3B,mBAAmB;IACnB,kDAAiC,CAAA;AACnC,CAAC,EA9BW,aAAa,KAAb,aAAa,QA8BxB;AASD,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAgB;IACpB,WAAW,CAAU;IACrB,OAAO,CAA2B;IAElD,YAAY,OAAyB;QACnC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAEM,MAAM;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/core/file_utils.d.ts

@@ -0,0 +1,13 @@
+export interface FileEntry {
+    path: string;
+    relativePath: string;
+    sizeBytes: number;
+}
+export declare class FileUtils {
+    static readFile(filePath: string, workspaceRoot?: string): Promise<string>;
+    static writeFile(filePath: string, content: string, workspaceRoot?: string): Promise<string>;
+    static fileExists(filePath: string, workspaceRoot?: string): Promise<boolean>;
+    static listLuaFiles(dirPath: string, workspaceRoot?: string): Promise<FileEntry[]>;
+    static listAllFiles(dirPath: string, workspaceRoot?: string): Promise<FileEntry[]>;
+}
+//# sourceMappingURL=file_utils.d.ts.map

package/dist/core/file_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_utils.d.ts","sourceRoot":"","sources":["../../src/core/file_utils.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,SAAS;WACA,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAKnE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;WAQrF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;WAUtE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;WAkC3E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAgChG"}

package/dist/core/file_utils.js

@@ -0,0 +1,90 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { PathGuard } from "../security/path_guard.js";
+export class FileUtils {
+    static async readFile(filePath, workspaceRoot) {
+        const safePath = PathGuard.resolveSafePath(filePath, workspaceRoot);
+        return await fs.readFile(safePath, "utf-8");
+    }
+    static async writeFile(filePath, content, workspaceRoot) {
+        const safePath = PathGuard.resolveSafePath(filePath, workspaceRoot);
+        const dir = path.dirname(safePath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(safePath, content, "utf-8");
+        return safePath;
+    }
+    static async fileExists(filePath, workspaceRoot) {
+        try {
+            const safePath = PathGuard.resolveSafePath(filePath, workspaceRoot);
+            const stat = await fs.stat(safePath);
+            return stat.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    static async listLuaFiles(dirPath, workspaceRoot) {
+        const safeDir = PathGuard.resolveSafePath(dirPath, workspaceRoot);
+        const results = [];
+        async function walk(currentDir) {
+            const entries = await fs.readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    // Skip node_modules, .git, and common cache dirs
+                    if (entry.name === "node_modules" || entry.name === ".git" || entry.name === ".cache") {
+                        continue;
+                    }
+                    await walk(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith(".lua")) {
+                    const stat = await fs.stat(fullPath);
+                    results.push({
+                        path: fullPath,
+                        relativePath: path.relative(safeDir, fullPath).replace(/\\/g, "/"),
+                        sizeBytes: stat.size
+                    });
+                }
+            }
+        }
+        try {
+            await walk(safeDir);
+        }
+        catch {
+            // directory might not exist yet
+        }
+        return results;
+    }
+    static async listAllFiles(dirPath, workspaceRoot) {
+        const safeDir = PathGuard.resolveSafePath(dirPath, workspaceRoot);
+        const results = [];
+        async function walk(currentDir) {
+            const entries = await fs.readdir(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (entry.name === "node_modules" || entry.name === ".git" || entry.name === ".cache") {
+                        continue;
+                    }
+                    await walk(fullPath);
+                }
+                else if (entry.isFile()) {
+                    const stat = await fs.stat(fullPath);
+                    results.push({
+                        path: fullPath,
+                        relativePath: path.relative(safeDir, fullPath).replace(/\\/g, "/"),
+                        sizeBytes: stat.size
+                    });
+                }
+            }
+        }
+        try {
+            await walk(safeDir);
+        }
+        catch {
+            // ignore missing
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=file_utils.js.map

package/dist/core/file_utils.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Structured Logger for mcp-garry-codes.
+ * CRITICAL: All logs MUST go to process.stderr. process.stdout is strictly reserved for MCP JSON-RPC messages.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+declare class Logger {
+    private level;
+    setLevel(level: LogLevel): void;
+    private shouldLog;
+    private formatMessage;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAoB;IAE1B,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAI/B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAMd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMpD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK7D;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,46 @@
+/**
+ * Structured Logger for mcp-garry-codes.
+ * CRITICAL: All logs MUST go to process.stderr. process.stdout is strictly reserved for MCP JSON-RPC messages.
+ */
+const LEVEL_SEVERITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+class Logger {
+    level = "info";
+    setLevel(level) {
+        this.level = level;
+    }
+    shouldLog(level) {
+        return LEVEL_SEVERITY[level] >= LEVEL_SEVERITY[this.level];
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const metaStr = meta && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+        return `[${timestamp}] [${level.toUpperCase()}] [mcp-garry-codes] ${message}${metaStr}\n`;
+    }
+    debug(message, meta) {
+        if (this.shouldLog("debug")) {
+            process.stderr.write(this.formatMessage("debug", message, meta));
+        }
+    }
+    info(message, meta) {
+        if (this.shouldLog("info")) {
+            process.stderr.write(this.formatMessage("info", message, meta));
+        }
+    }
+    warn(message, meta) {
+        if (this.shouldLog("warn")) {
+            process.stderr.write(this.formatMessage("warn", message, meta));
+        }
+    }
+    error(message, meta) {
+        if (this.shouldLog("error")) {
+            process.stderr.write(this.formatMessage("error", message, meta));
+        }
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,MAAM;IACF,KAAK,GAAa,MAAM,CAAC;IAE1B,QAAQ,CAAC,KAAe;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;QACpF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,uBAAuB,OAAO,GAAG,OAAO,IAAI,CAAC;IAC5F,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAA8B;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAA8B;QACzD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAA8B;QACzD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAA8B;QAC1D,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/core/process_runner.d.ts

@@ -0,0 +1,15 @@
+export interface ProcessRunOptions {
+    cwd?: string;
+    timeoutMs?: number;
+    env?: Record<string, string>;
+    maxBuffer?: number;
+}
+export interface ProcessRunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare class ProcessRunner {
+    static execute(binary: string, args: string[], options?: ProcessRunOptions): Promise<ProcessRunResult>;
+}
+//# sourceMappingURL=process_runner.d.ts.map

package/dist/core/process_runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process_runner.d.ts","sourceRoot":"","sources":["../../src/core/process_runner.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;WACJ,OAAO,CACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;CAqE7B"}

package/dist/core/process_runner.js

@@ -0,0 +1,64 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { ProcessGuard } from "../security/process_guard.js";
+import { GModErrorCode, GModMCPError } from "./errors.js";
+import { logger } from "./logger.js";
+const execFileAsync = promisify(execFile);
+export class ProcessRunner {
+    static async execute(binary, args, options) {
+        ProcessGuard.validateArgs(args);
+        const timeout = options?.timeoutMs ?? 10000;
+        const maxBuffer = options?.maxBuffer ?? 10 * 1024 * 1024; // 10MB buffer
+        logger.debug(`Executing subprocess: ${binary} ${args.join(" ")}`, {
+            binary,
+            args,
+            cwd: options?.cwd,
+            timeout
+        });
+        try {
+            const { stdout, stderr } = await execFileAsync(binary, args, {
+                cwd: options?.cwd,
+                timeout,
+                maxBuffer,
+                shell: false,
+                env: {
+                    ...process.env,
+                    ...(options?.env ?? {})
+                }
+            });
+            return {
+                stdout: stdout.toString(),
+                stderr: stderr.toString(),
+                exitCode: 0
+            };
+        }
+        catch (err) {
+            const error = err;
+            const stdout = error.stdout?.toString() ?? "";
+            const stderr = error.stderr?.toString() ?? "";
+            if (error.killed || error.signal === "SIGTERM") {
+                throw new GModMCPError({
+                    code: GModErrorCode.PROCESS_TIMEOUT,
+                    message: `Process '${binary}' timed out after ${timeout}ms.`,
+                    remediation: "Increase timeout_ms or inspect the target script for infinite loops.",
+                    context: { binary, timeout, stdout, stderr }
+                });
+            }
+            // If it returned a non-zero exit code, return the result so caller can inspect linter/test errors
+            if (typeof error.code === "number") {
+                return {
+                    stdout,
+                    stderr,
+                    exitCode: error.code
+                };
+            }
+            throw new GModMCPError({
+                code: GModErrorCode.PROCESS_EXECUTION_FAILED,
+                message: `Failed to execute binary '${binary}': ${error.message ?? String(err)}`,
+                remediation: `Verify that '${binary}' is installed and present in your system PATH or environment configuration.`,
+                context: { binary, args }
+            });
+        }
+    }
+}
+//# sourceMappingURL=process_runner.js.map