mcp-garry-codes 1.0.0

package/dist/resources/schema_resources.d.ts

@@ -0,0 +1,2 @@
+export declare function getAddonJsonSchemaContent(): string;
+//# sourceMappingURL=schema_resources.d.ts.map

package/dist/resources/schema_resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_resources.d.ts","sourceRoot":"","sources":["../../src/resources/schema_resources.ts"],"names":[],"mappings":"AAAA,wBAAgB,yBAAyB,IAAI,MAAM,CA6ClD"}

package/dist/resources/schema_resources.js

@@ -0,0 +1,43 @@
+export function getAddonJsonSchemaContent() {
+    return JSON.stringify({
+        description: "Garry's Mod addon.json Steam Workshop Schema",
+        type: "object",
+        required: ["title", "type", "tags", "ignore"],
+        properties: {
+            title: {
+                type: "string",
+                description: "Human-readable name of the addon displayed in Steam Workshop."
+            },
+            type: {
+                type: "string",
+                enum: [
+                    "ServerContent",
+                    "gamemode",
+                    "map",
+                    "weapon",
+                    "vehicle",
+                    "npc",
+                    "tool",
+                    "effects",
+                    "model"
+                ],
+                description: "Addon primary category classification."
+            },
+            tags: {
+                type: "array",
+                maxItems: 2,
+                items: {
+                    type: "string",
+                    enum: ["fun", "roleplay", "scenic", "movie", "realism", "comic", "build"]
+                },
+                description: "Up to 2 tags to categorize the addon on Steam."
+            },
+            ignore: {
+                type: "array",
+                items: { type: "string" },
+                description: "Glob patterns of files to exclude from compiled GMA package."
+            }
+        }
+    }, null, 2);
+}
+//# sourceMappingURL=schema_resources.js.map

package/dist/resources/schema_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_resources.js","sourceRoot":"","sources":["../../src/resources/schema_resources.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,WAAW,EAAE,8CAA8C;QAC3D,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QAC7C,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE;oBACJ,eAAe;oBACf,UAAU;oBACV,KAAK;oBACL,QAAQ;oBACR,SAAS;oBACT,KAAK;oBACL,MAAM;oBACN,SAAS;oBACT,OAAO;iBACR;gBACD,WAAW,EAAE,wCAAwC;aACtD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;iBAC1E;gBACD,WAAW,EAAE,gDAAgD;aAC9D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,8DAA8D;aAC5E;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/wiki_resources.d.ts

@@ -0,0 +1,3 @@
+export declare function getHooksResourceContent(): string;
+export declare function getLibrariesResourceContent(): string;
+//# sourceMappingURL=wiki_resources.d.ts.map

package/dist/resources/wiki_resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_resources.d.ts","sourceRoot":"","sources":["../../src/resources/wiki_resources.ts"],"names":[],"mappings":"AAEA,wBAAgB,uBAAuB,IAAI,MAAM,CAkBhD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAiBpD"}

package/dist/resources/wiki_resources.js

@@ -0,0 +1,31 @@
+import { GMOD_OFFLINE_DOCS } from "../domain/wiki/offline_db.js";
+export function getHooksResourceContent() {
+    const hooks = GMOD_OFFLINE_DOCS.filter(d => d.category === "hooks");
+    return JSON.stringify({
+        description: "Garry's Mod Core Hooks Reference",
+        total: hooks.length,
+        hooks: hooks.map(h => ({
+            name: h.symbol,
+            realm: h.realm,
+            signature: h.signature,
+            description: h.description,
+            warnings: h.warnings,
+            wiki_url: h.wiki_url
+        }))
+    }, null, 2);
+}
+export function getLibrariesResourceContent() {
+    const libs = GMOD_OFFLINE_DOCS.filter(d => d.category === "functions" || d.category === "libraries");
+    return JSON.stringify({
+        description: "Garry's Mod Core Functions & Libraries Reference",
+        total: libs.length,
+        entries: libs.map(l => ({
+            name: l.symbol,
+            realm: l.realm,
+            signature: l.signature,
+            description: l.description,
+            wiki_url: l.wiki_url
+        }))
+    }, null, 2);
+}
+//# sourceMappingURL=wiki_resources.js.map

package/dist/resources/wiki_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki_resources.js","sourceRoot":"","sources":["../../src/resources/wiki_resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,WAAW,EAAE,kCAAkC;QAC/C,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/security/path_guard.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Path Guard: Enforces strict jail boundaries on workspace files to prevent directory traversal attacks.
+ */
+export declare class PathGuard {
+    static resolveSafePath(filePath: string, customRoot?: string): string;
+    static isSafePath(filePath: string, customRoot?: string): boolean;
+}
+//# sourceMappingURL=path_guard.d.ts.map

package/dist/security/path_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path_guard.d.ts","sourceRoot":"","sources":["../../src/security/path_guard.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,SAAS;WACN,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;WAyB9D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;CAQzE"}

package/dist/security/path_guard.js

@@ -0,0 +1,37 @@
+import path from "node:path";
+import { GModErrorCode, GModMCPError } from "../core/errors.js";
+import { getConfig } from "../config/env.js";
+/**
+ * Path Guard: Enforces strict jail boundaries on workspace files to prevent directory traversal attacks.
+ */
+export class PathGuard {
+    static resolveSafePath(filePath, customRoot) {
+        const root = path.resolve(customRoot ?? getConfig().WORKSPACE_ROOT);
+        const resolved = path.resolve(root, filePath);
+        // Normalize both for platform-agnostic comparison (especially Windows lowercasing/slashes)
+        const normalizedRoot = path.normalize(root).toLowerCase();
+        const normalizedResolved = path.normalize(resolved).toLowerCase();
+        // Check if the resolved path is either the root itself or starts with root + separator
+        const isInside = normalizedResolved === normalizedRoot ||
+            normalizedResolved.startsWith(normalizedRoot + path.sep);
+        if (!isInside) {
+            throw new GModMCPError({
+                code: GModErrorCode.PATH_JAIL_VIOLATION,
+                message: `Security violation: Path '${filePath}' attempts to escape the allowed workspace boundary '${root}'.`,
+                remediation: "Ensure the path stays within the workspace root directory.",
+                context: { attemptedPath: filePath, workspaceRoot: root }
+            });
+        }
+        return resolved;
+    }
+    static isSafePath(filePath, customRoot) {
+        try {
+            this.resolveSafePath(filePath, customRoot);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=path_guard.js.map

package/dist/security/path_guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path_guard.js","sourceRoot":"","sources":["../../src/security/path_guard.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,SAAS;IACb,MAAM,CAAC,eAAe,CAAC,QAAgB,EAAE,UAAmB;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC,cAAc,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE9C,2FAA2F;QAC3F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAElE,uFAAuF;QACvF,MAAM,QAAQ,GACZ,kBAAkB,KAAK,cAAc;YACrC,kBAAkB,CAAC,UAAU,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAE3D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,YAAY,CAAC;gBACrB,IAAI,EAAE,aAAa,CAAC,mBAAmB;gBACvC,OAAO,EAAE,6BAA6B,QAAQ,wDAAwD,IAAI,IAAI;gBAC9G,WAAW,EAAE,4DAA4D;gBACzE,OAAO,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE;aAC1D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,QAAgB,EAAE,UAAmB;QAC5D,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/security/process_guard.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Process Guard: Restricts command execution to safe argument arrays, blocking shell metacharacters.
+ */
+export declare class ProcessGuard {
+    private static DANGEROUS_PATTERNS;
+    static validateArgs(args: string[]): void;
+}
+//# sourceMappingURL=process_guard.d.ts.map

package/dist/security/process_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process_guard.d.ts","sourceRoot":"","sources":["../../src/security/process_guard.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAG/B;WAEY,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;CAcjD"}

package/dist/security/process_guard.js

@@ -0,0 +1,26 @@
+import { GModErrorCode, GModMCPError } from "../core/errors.js";
+/**
+ * Process Guard: Restricts command execution to safe argument arrays, blocking shell metacharacters.
+ */
+export class ProcessGuard {
+    // Disallowed argument strings that could trick argument parsers
+    static DANGEROUS_PATTERNS = [
+        /[;&|`$]/, // Shell command delimiters
+        /\x00/ // Null bytes
+    ];
+    static validateArgs(args) {
+        for (const arg of args) {
+            for (const pattern of this.DANGEROUS_PATTERNS) {
+                if (pattern.test(arg)) {
+                    throw new GModMCPError({
+                        code: GModErrorCode.COMMAND_INJECTION_DETECTED,
+                        message: `Command injection risk detected in argument: '${arg}'`,
+                        remediation: "Ensure arguments do not contain shell control characters or null bytes.",
+                        context: { arg }
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=process_guard.js.map

package/dist/security/process_guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process_guard.js","sourceRoot":"","sources":["../../src/security/process_guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB,gEAAgE;IACxD,MAAM,CAAC,kBAAkB,GAAG;QAClC,SAAS,EAAE,2BAA2B;QACtC,MAAM,CAAC,aAAa;KACrB,CAAC;IAEK,MAAM,CAAC,YAAY,CAAC,IAAc;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtB,MAAM,IAAI,YAAY,CAAC;wBACrB,IAAI,EAAE,aAAa,CAAC,0BAA0B;wBAC9C,OAAO,EAAE,iDAAiD,GAAG,GAAG;wBAChE,WAAW,EAAE,yEAAyE;wBACtF,OAAO,EAAE,EAAE,GAAG,EAAE;qBACjB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC"}

package/dist/security/redaction.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Redaction utility for protecting sensitive credentials (Steam API keys, RCON passwords, MySQL strings).
+ */
+export declare function redactSensitiveData(input: string): string;
+export declare function sanitizeEnvelope<T>(data: T): T;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/security/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/security/redaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyBH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAe9C"}

package/dist/security/redaction.js

@@ -0,0 +1,49 @@
+/**
+ * Redaction utility for protecting sensitive credentials (Steam API keys, RCON passwords, MySQL strings).
+ */
+const REDACTION_PATTERNS = [
+    // Steam Web API Key: 32 hex chars
+    {
+        pattern: /\b[0-9A-F]{32}\b/gi,
+        replacement: "[REDACTED_STEAM_KEY]"
+    },
+    // RCON password: rcon_password "secret" or rcon_password = "secret"
+    {
+        pattern: /(rcon_password\s*[="']\s*)([^"'\s;]+)/gi,
+        replacement: "$1[REDACTED_RCON_PASSWORD]"
+    },
+    // MySQL connection string passwords
+    {
+        pattern: /(password\s*[:=]\s*["'])([^"']+)(["'])/gi,
+        replacement: "$1[REDACTED_PASSWORD]$3"
+    },
+    // Generic Bearer / Secret tokens
+    {
+        pattern: /(bearer\s+)([a-zA-Z0-9_\-\.]{15,})/gi,
+        replacement: "$1[REDACTED_TOKEN]"
+    }
+];
+export function redactSensitiveData(input) {
+    let result = input;
+    for (const { pattern, replacement } of REDACTION_PATTERNS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+export function sanitizeEnvelope(data) {
+    if (typeof data === "string") {
+        return redactSensitiveData(data);
+    }
+    if (Array.isArray(data)) {
+        return data.map(item => sanitizeEnvelope(item));
+    }
+    if (data !== null && typeof data === "object") {
+        const sanitizedObj = {};
+        for (const [key, value] of Object.entries(data)) {
+            sanitizedObj[key] = sanitizeEnvelope(value);
+        }
+        return sanitizedObj;
+    }
+    return data;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/security/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/security/redaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,kBAAkB,GAAoD;IAC1E,kCAAkC;IAClC;QACE,OAAO,EAAE,oBAAoB;QAC7B,WAAW,EAAE,sBAAsB;KACpC;IACD,oEAAoE;IACpE;QACE,OAAO,EAAE,yCAAyC;QAClD,WAAW,EAAE,4BAA4B;KAC1C;IACD,oCAAoC;IACpC;QACE,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,yBAAyB;KACvC;IACD,iCAAiC;IACjC;QACE,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EAAE,oBAAoB;KAClC;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,kBAAkB,EAAE,CAAC;QAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,IAAO;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,mBAAmB,CAAC,IAAI,CAAiB,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAiB,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,YAAY,GAA4B,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC3E,YAAY,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,YAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAoCnE,wBAAgB,YAAY,IAAI,MAAM,CAkWrC"}

package/dist/server.js

@@ -0,0 +1,364 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { logger } from "./core/logger.js";
+import { sanitizeEnvelope } from "./security/redaction.js";
+// Tool handlers
+import { handleSearchGModWiki } from "./tools/search_gmod_wiki.js";
+import { handleGetGModSymbol } from "./tools/get_gmod_symbol.js";
+import { handleWebSearchGLua } from "./tools/web_search_glua.js";
+import { handleLintGLua } from "./tools/lint_glua.js";
+import { handleAuditNetSecurity } from "./tools/audit_net_security.js";
+import { handleAnalyzePerformance } from "./tools/analyze_performance.js";
+import { handleScaffoldGModComponent } from "./tools/scaffold_gmod_component.js";
+import { handleRunGLuaTest } from "./tools/run_glua_test.js";
+import { handlePackageAndValidate } from "./tools/package_and_validate.js";
+// Resources
+import { getHooksResourceContent, getLibrariesResourceContent } from "./resources/wiki_resources.js";
+import { getRealmsMatrixContent } from "./resources/realms_resources.js";
+import { getAddonJsonSchemaContent } from "./resources/schema_resources.js";
+// Prompts
+import { AUDIT_ADDON_PROMPT, FIX_NET_EXPLOIT_PROMPT, SCAFFOLD_SWEP_PROMPT, BUILD_DERMA_MENU_PROMPT } from "./prompts/index.js";
+export function createServer() {
+    const server = new Server({
+        name: "mcp-garry-codes",
+        version: "1.0.0"
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {}
+        }
+    });
+    // 1. Tools Registration
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: "search_gmod_wiki",
+                    description: "Query Facepunch Garry's Mod Wiki and indexed community documentation for functions, hooks, libraries, panels, and engine behavior.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: { type: "string", description: "Search term (e.g. 'net.Receive', 'GM:PlayerInitialSpawn')" },
+                            category: {
+                                type: "string",
+                                enum: ["functions", "hooks", "libraries", "panels", "enums", "all"],
+                                default: "all",
+                                description: "Filter search by category"
+                            },
+                            realm: {
+                                type: "string",
+                                enum: ["server", "client", "shared", "menu", "all"],
+                                default: "all",
+                                description: "Filter by execution realm"
+                            },
+                            max_results: { type: "integer", minimum: 1, maximum: 20, default: 5, description: "Max results to return" }
+                        },
+                        required: ["query"]
+                    }
+                },
+                {
+                    name: "get_gmod_symbol",
+                    description: "Retrieve comprehensive documentation for a specific Garry's Mod symbol including realm, arguments, return types, code examples, and caveats.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            symbol: { type: "string", description: "Exact symbol name (e.g. 'surface.DrawPoly', 'util.AddNetworkString')" },
+                            include_examples: { type: "boolean", default: true, description: "Include official usage examples" }
+                        },
+                        required: ["symbol"]
+                    }
+                },
+                {
+                    name: "web_search_glua",
+                    description: "Search GMod developer communities, GitHub repositories, and forums for undocumented quirks and solutions.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            query: { type: "string", description: "Target query" },
+                            domain_filter: {
+                                type: "string",
+                                enum: ["github", "facepunch", "reddit", "steam", "all"],
+                                default: "all",
+                                description: "Target community platform"
+                            },
+                            max_results: { type: "integer", minimum: 1, maximum: 10, default: 5, description: "Max results" }
+                        },
+                        required: ["query"]
+                    }
+                },
+                {
+                    name: "lint_glua",
+                    description: "Deep static analysis on GLua code catching syntax errors, realm mismatches, global pollution, and missing AddCSLuaFile.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            file_path: { type: "string", description: "Workspace-relative or absolute path to .lua file" },
+                            code_content: { type: "string", description: "Direct Lua code string to analyze (if file_path omitted)" },
+                            target_realm: {
+                                type: "string",
+                                enum: ["server", "client", "shared", "menu", "auto"],
+                                default: "auto",
+                                description: "Target realm context"
+                            },
+                            fix_formatting: { type: "boolean", default: false, description: "Auto-fix code if possible" }
+                        }
+                    }
+                },
+                {
+                    name: "audit_net_security",
+                    description: "Analyze network message graphs across an addon to identify unauthenticated receivers, SQL injection vectors, and missing network strings.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            addon_dir: { type: "string", description: "Root directory of addon (defaults to workspace)" },
+                            file_paths: { type: "array", items: { type: "string" }, description: "Specific files to scan" }
+                        }
+                    }
+                },
+                {
+                    name: "analyze_performance",
+                    description: "Profile GLua code for runtime performance traps: Zero-GC violations in render/think hooks, uncached fonts/materials, unlocalized globals.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            file_path: { type: "string", description: "Workspace path to .lua file" },
+                            code_content: { type: "string", description: "Direct Lua code snippet" }
+                        }
+                    }
+                },
+                {
+                    name: "scaffold_gmod_component",
+                    description: "Generate idiomatically realm-separated Garry's Mod boilerplate for SWEP, SENT, VGUI panels, HUDs, or gamemodes.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            component_type: {
+                                type: "string",
+                                enum: ["swep", "sent", "vgui_panel", "custom_tool", "hud", "gamemode", "addon_skeleton"],
+                                description: "Type of Garry's Mod component to scaffold"
+                            },
+                            name: { type: "string", description: "Identifier (e.g. 'weapon_plasma_rifle', 'ent_crate')" },
+                            output_dir: { type: "string", description: "Workspace folder to write generated files to" },
+                            options: {
+                                type: "object",
+                                properties: {
+                                    category: { type: "string" },
+                                    base: { type: "string" },
+                                    author: { type: "string" },
+                                    printable_name: { type: "string" },
+                                    vgui_type: { type: "string", enum: ["frame", "button", "scroll", "custom"] }
+                                }
+                            }
+                        },
+                        required: ["component_type", "name"]
+                    }
+                },
+                {
+                    name: "run_glua_test",
+                    description: "Execute headless GLua unit tests using the embedded Source Engine mock runtime.",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            test_file_path: { type: "string", description: "Workspace path to test script" },
+                            code_to_test: { type: "string", description: "Inline GLua test code with assertions" },
+                            mock_realm: { type: "string", enum: ["client", "server", "shared"], default: "shared" },
+                            timeout_ms: { type: "integer", default: 5000, description: "Max timeout in ms" }
+                        }
+                    }
+                },
+                {
+                    name: "package_and_validate",
+                    description: "Verify an addon directory against Steam Workshop and GMA packaging rules (addon.json validation, file whitelist, casing).",
+                    inputSchema: {
+                        type: "object",
+                        properties: {
+                            addon_dir: { type: "string", description: "Root directory of addon (defaults to workspace)" },
+                            build_gma: { type: "boolean", default: false, description: "Compile .gma package if gmad is available" },
+                            output_gma_path: { type: "string", description: "Destination path for .gma" }
+                        }
+                    }
+                }
+            ]
+        };
+    });
+    // 2. Tools Execution
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        logger.info(`Tool called: ${name}`, { args });
+        try {
+            let result;
+            switch (name) {
+                case "search_gmod_wiki":
+                    result = await handleSearchGModWiki(args);
+                    break;
+                case "get_gmod_symbol":
+                    result = await handleGetGModSymbol(args);
+                    break;
+                case "web_search_glua":
+                    result = await handleWebSearchGLua(args);
+                    break;
+                case "lint_glua":
+                    result = await handleLintGLua(args);
+                    break;
+                case "audit_net_security":
+                    result = await handleAuditNetSecurity(args);
+                    break;
+                case "analyze_performance":
+                    result = await handleAnalyzePerformance(args);
+                    break;
+                case "scaffold_gmod_component":
+                    result = await handleScaffoldGModComponent(args);
+                    break;
+                case "run_glua_test":
+                    result = await handleRunGLuaTest(args);
+                    break;
+                case "package_and_validate":
+                    result = await handlePackageAndValidate(args);
+                    break;
+                default:
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify({
+                                    status: "failed",
+                                    summary: `Unknown tool '${name}'.`,
+                                    data: null,
+                                    warnings: [`Tool '${name}' is not registered on this server.`]
+                                })
+                            }
+                        ],
+                        isError: true
+                    };
+            }
+            // Redact sensitive keys before transmission
+            const sanitized = sanitizeEnvelope(result);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(sanitized, null, 2)
+                    }
+                ],
+                isError: sanitized.status === "failed"
+            };
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            logger.error(`Error executing tool '${name}': ${errorMsg}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "failed",
+                            summary: `Tool execution failed: ${errorMsg}`,
+                            data: null,
+                            warnings: [errorMsg]
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    });
+    // 3. Resources Registration
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: "gmod://wiki/hooks",
+                    name: "Garry's Mod Core Hooks Reference",
+                    mimeType: "application/json",
+                    description: "Authoritative list of Garry's Mod hooks across all realms."
+                },
+                {
+                    uri: "gmod://wiki/libraries",
+                    name: "Garry's Mod Core Libraries & Global Functions",
+                    mimeType: "application/json",
+                    description: "Core functions and libraries available in GLua."
+                },
+                {
+                    uri: "gmod://realms/matrix",
+                    name: "Garry's Mod Realm Matrix",
+                    mimeType: "application/json",
+                    description: "Execution realm boundaries, powers, and restrictions."
+                },
+                {
+                    uri: "gmod://schemas/addon_json",
+                    name: "Steam Workshop addon.json Schema",
+                    mimeType: "application/json",
+                    description: "Schema specification for Garry's Mod addon.json."
+                }
+            ]
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        switch (uri) {
+            case "gmod://wiki/hooks":
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: getHooksResourceContent() }]
+                };
+            case "gmod://wiki/libraries":
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: getLibrariesResourceContent() }]
+                };
+            case "gmod://realms/matrix":
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: getRealmsMatrixContent() }]
+                };
+            case "gmod://schemas/addon_json":
+                return {
+                    contents: [{ uri, mimeType: "application/json", text: getAddonJsonSchemaContent() }]
+                };
+            default:
+                throw new Error(`Resource not found: ${uri}`);
+        }
+    });
+    // 4. Prompts Registration
+    server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        return {
+            prompts: [
+                {
+                    name: AUDIT_ADDON_PROMPT.name,
+                    description: AUDIT_ADDON_PROMPT.description,
+                    arguments: AUDIT_ADDON_PROMPT.arguments
+                },
+                {
+                    name: FIX_NET_EXPLOIT_PROMPT.name,
+                    description: FIX_NET_EXPLOIT_PROMPT.description,
+                    arguments: FIX_NET_EXPLOIT_PROMPT.arguments
+                },
+                {
+                    name: SCAFFOLD_SWEP_PROMPT.name,
+                    description: SCAFFOLD_SWEP_PROMPT.description,
+                    arguments: SCAFFOLD_SWEP_PROMPT.arguments
+                },
+                {
+                    name: BUILD_DERMA_MENU_PROMPT.name,
+                    description: BUILD_DERMA_MENU_PROMPT.description,
+                    arguments: BUILD_DERMA_MENU_PROMPT.arguments
+                }
+            ]
+        };
+    });
+    server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case AUDIT_ADDON_PROMPT.name:
+                return AUDIT_ADDON_PROMPT.handler(args);
+            case FIX_NET_EXPLOIT_PROMPT.name:
+                return FIX_NET_EXPLOIT_PROMPT.handler(args);
+            case SCAFFOLD_SWEP_PROMPT.name:
+                return SCAFFOLD_SWEP_PROMPT.handler(args);
+            case BUILD_DERMA_MENU_PROMPT.name:
+                return BUILD_DERMA_MENU_PROMPT.handler(args);
+            default:
+                throw new Error(`Prompt not found: ${name}`);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map