exoproc 0.1.0 → 0.6.2

package/dist/setup/index.js

@@ -0,0 +1,445 @@
+// @bun
+// packages/exoproc/src/setup/index.ts
+import { homedir } from "os";
+import { join as join3 } from "path";
+
+// packages/exoproc/src/setup/clients.ts
+import { existsSync } from "fs";
+import { dirname, join } from "path";
+var SUPPORTED_CLIENTS = [
+  {
+    id: "claude_code",
+    displayName: "Claude Code",
+    format: "json",
+    getConfigPaths: (ctx) => [join(ctx.home, ".claude.json")],
+    getSkillPaths: (ctx) => [
+      join(ctx.home, ".claude", "skills", "exoproc", "SKILL.md"),
+      join(ctx.home, ".claude", "commands", "exoproc.md")
+    ],
+    detect: (ctx) => existsSync(join(ctx.home, ".claude")) || existsSync(join(ctx.home, ".claude.json"))
+  },
+  {
+    id: "cursor",
+    displayName: "Cursor",
+    format: "json",
+    getConfigPaths: (ctx) => {
+      const paths = [join(ctx.home, ".cursor", "mcp.json")];
+      const localCursor = join(ctx.cwd, ".cursor");
+      if (existsSync(localCursor)) {
+        paths.push(join(localCursor, "mcp.json"));
+      }
+      return paths;
+    },
+    getSkillPaths: (ctx) => [
+      join(ctx.home, ".cursor", "rules", "exoproc.mdc")
+    ],
+    detect: (ctx) => existsSync(join(ctx.home, ".cursor")) || existsSync(join(ctx.cwd, ".cursor"))
+  },
+  {
+    id: "windsurf",
+    displayName: "Windsurf",
+    format: "json",
+    getConfigPaths: (ctx) => [
+      join(ctx.home, ".codeium", "windsurf", "mcp_config.json")
+    ],
+    detect: (ctx) => existsSync(join(ctx.home, ".codeium", "windsurf"))
+  },
+  {
+    id: "claude_desktop",
+    displayName: "Claude Desktop",
+    format: "json",
+    getConfigPaths: (ctx) => {
+      if (ctx.platform === "win32") {
+        const appData = ctx.env.APPDATA || join(ctx.home, "AppData", "Roaming");
+        return [join(appData, "Claude", "claude_desktop_config.json")];
+      }
+      if (ctx.platform === "darwin") {
+        return [
+          join(ctx.home, "Library", "Application Support", "Claude", "claude_desktop_config.json")
+        ];
+      }
+      return [
+        join(ctx.home, ".config", "Claude", "claude_desktop_config.json")
+      ];
+    },
+    detect: (ctx) => {
+      const paths = SUPPORTED_CLIENTS.find((c) => c.id === "claude_desktop").getConfigPaths(ctx);
+      return paths.some((p) => existsSync(dirname(p)) || existsSync(p));
+    }
+  },
+  {
+    id: "gemini_cli",
+    displayName: "Gemini CLI / Antigravity",
+    format: "json",
+    getConfigPaths: (ctx) => {
+      const paths = [
+        join(ctx.home, ".gemini", "antigravity", "mcp_config.json"),
+        join(ctx.home, ".gemini", "settings.json")
+      ];
+      if (existsSync(join(ctx.cwd, ".gemini"))) {
+        paths.push(join(ctx.cwd, ".gemini", "mcp_config.json"));
+      }
+      return paths;
+    },
+    getSkillPaths: (ctx) => [
+      join(ctx.home, ".gemini", "antigravity", "skills", "exoproc", "SKILL.md"),
+      join(ctx.home, ".agents", "skills", "exoproc", "SKILL.md")
+    ],
+    detect: (ctx) => existsSync(join(ctx.home, ".gemini")) || existsSync(join(ctx.home, ".agents"))
+  },
+  {
+    id: "cline",
+    displayName: "VS Code Cline / Roo Code",
+    format: "json",
+    getConfigPaths: (ctx) => {
+      const paths = [];
+      const codeDir = ctx.platform === "win32" ? join(ctx.env.APPDATA || join(ctx.home, "AppData", "Roaming"), "Code", "User", "globalStorage") : ctx.platform === "darwin" ? join(ctx.home, "Library", "Application Support", "Code", "User", "globalStorage") : join(ctx.home, ".config", "Code", "User", "globalStorage");
+      paths.push(join(codeDir, "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"), join(codeDir, "rooveterinaryinc.roo-cline", "settings", "cline_mcp_settings.json"));
+      if (existsSync(join(ctx.cwd, ".vscode"))) {
+        paths.push(join(ctx.cwd, ".vscode", "mcp.json"));
+      }
+      return paths;
+    },
+    detect: (ctx) => {
+      const paths = SUPPORTED_CLIENTS.find((c) => c.id === "cline").getConfigPaths(ctx);
+      return paths.some((p) => existsSync(dirname(p)) || existsSync(p));
+    }
+  },
+  {
+    id: "opencode",
+    displayName: "OpenCode",
+    format: "json",
+    getConfigPaths: (ctx) => [
+      join(ctx.home, ".config", "opencode", "opencode.json"),
+      join(ctx.home, ".config", "opencode", "mcp.json")
+    ],
+    detect: (ctx) => existsSync(join(ctx.home, ".config", "opencode"))
+  },
+  {
+    id: "zed",
+    displayName: "Zed",
+    format: "zed",
+    getConfigPaths: (ctx) => {
+      if (ctx.platform === "win32") {
+        const appData = ctx.env.APPDATA || join(ctx.home, "AppData", "Roaming");
+        return [join(appData, "Zed", "settings.json")];
+      }
+      return [join(ctx.home, ".config", "zed", "settings.json")];
+    },
+    detect: (ctx) => {
+      const paths = SUPPORTED_CLIENTS.find((c) => c.id === "zed").getConfigPaths(ctx);
+      return paths.some((p) => existsSync(dirname(p)) || existsSync(p));
+    }
+  }
+];
+
+// packages/exoproc/src/setup/config-writer.ts
+import {
+  copyFileSync,
+  existsSync as existsSync2,
+  mkdirSync,
+  readFileSync,
+  writeFileSync
+} from "fs";
+import { dirname as dirname2 } from "path";
+function parseJsonc(content) {
+  const cleaned = content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^\\:])\/\/.*$/gm, "$1").replace(/,\s*([}\]])/g, "$1");
+  return JSON.parse(cleaned);
+}
+function isClientConfigured(client, configPath, command) {
+  if (!existsSync2(configPath))
+    return false;
+  try {
+    const raw = readFileSync(configPath, "utf8");
+    const doc = parseJsonc(raw);
+    if (client.format === "zed") {
+      const entry = doc?.context_servers?.exoproc;
+      if (!entry)
+        return false;
+      const cmdPath = entry?.command?.path;
+      const cmdArgs = entry?.command?.args;
+      return cmdPath === command[0] && Array.isArray(cmdArgs) && cmdArgs.join(" ") === command.slice(1).join(" ");
+    } else {
+      const entry = doc?.mcpServers?.exoproc;
+      if (!entry)
+        return false;
+      return entry.command === command[0] && Array.isArray(entry.args) && entry.args.join(" ") === command.slice(1).join(" ");
+    }
+  } catch {
+    return false;
+  }
+}
+function updateClientConfig(client, configPath, command, dryRun = false) {
+  try {
+    let doc = {};
+    if (existsSync2(configPath)) {
+      const content = readFileSync(configPath, "utf8");
+      try {
+        doc = parseJsonc(content);
+      } catch (err) {
+        return {
+          path: configPath,
+          status: "failed",
+          error: `Existing config at ${configPath} is not valid JSON/JSONC: ${err.message}`
+        };
+      }
+    }
+    if (isClientConfigured(client, configPath, command)) {
+      return { path: configPath, status: "already_current" };
+    }
+    if (dryRun) {
+      return { path: configPath, status: "configured" };
+    }
+    const dir = dirname2(configPath);
+    if (!existsSync2(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    let backupPath;
+    if (existsSync2(configPath)) {
+      backupPath = `${configPath}.exoproc.bak`;
+      copyFileSync(configPath, backupPath);
+    }
+    if (client.format === "zed") {
+      doc.context_servers = doc.context_servers || {};
+      doc.context_servers.exoproc = {
+        command: {
+          path: command[0],
+          args: command.slice(1)
+        }
+      };
+    } else {
+      doc.mcpServers = doc.mcpServers || {};
+      doc.mcpServers.exoproc = {
+        command: command[0],
+        args: command.slice(1)
+      };
+    }
+    writeFileSync(configPath, JSON.stringify(doc, null, 2) + `
+`, "utf8");
+    return {
+      path: configPath,
+      status: "configured",
+      backupPath
+    };
+  } catch (err) {
+    return {
+      path: configPath,
+      status: "failed",
+      error: err?.message || String(err)
+    };
+  }
+}
+
+// packages/exoproc/src/setup/skill-installer.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname3, join as join2 } from "path";
+var DEFAULT_SKILL_CONTENT = `---
+name: exoproc
+description: >-
+  Native Windows x64 reverse engineering, thread hijacking (nthread), function redirection (minhook 5-byte detour), memory inspection, live Win32 code execution, remote desktop inspection, and JVM analysis via the Exoproc MCP Server.
+---
+
+# Exoproc MCP Server Guide
+
+Exoproc is a dedicated **Model Context Protocol (MCP)** server for native Windows x64 reverse engineering, thread hijacking (\`nthread\`), function redirection (\`minhook\`), live process instrumentation, and remote desktop inspection.
+
+> **Important Rule for AI Agents:** When asked to automate, inspect, or instrument a live process (e.g., typing into Notepad, reading/writing memory, calling Win32 APIs, or hooking functions), **use the Exoproc MCP tools directly**. Do **not** search the workspace repository source code unless explicitly asked to modify Exoproc itself.
+
+---
+
+## 1. Single Active Accessor Session Lifecycle (Mandatory Workflow)
+
+The MCP server maintains **at most ONE active accessor session** at any time.
+
+### The Required 3-Step Lifecycle:
+\`\`\`
+1. list_processes / list_windows  --> Find target PID
+2. open_accessor({ pid })          --> Opens the single active session (returns sessionId)
+3. execute_code / read_memory / ...--> Operates on the active session
+4. close_accessor({})              --> Restores target thread execution and closes session
+\`\`\`
+
+- **\`open_accessor({ pid: number })\` is mandatory:** \`execute_code\` and memory tools will NOT automatically open an accessor for you. You must explicitly open the session first.
+- **Single active session:** Only 1 process can be attached at a time. If you attempt to call \`open_accessor\` while a session is already active, it will return an error instructing you to call \`close_accessor\` first.
+- **Convenience in subsequent calls:** Once \`open_accessor\` is called, tools like \`execute_code({ code: ... })\`, \`read_memory(...)\`, \`write_memory(...)\`, etc. automatically operate on the currently active session \u2014 you do not even need to pass \`session\` on every call.
+- **Clean exit:** Always call \`close_accessor({})\` when you are done with your task.
+
+---
+
+## 2. C-Style Win32 Code Execution (\`execute_code\` & \`execute_local_code\`)
+
+Inside \`execute_code\`, write real Win32 C code as if \`<windows.h>\` were already included at the top:
+
+### Pre-Included Globally in Scope:
+1. **All Win32 \`#define\` Constants:**
+   - Window messages: \`WM_SETTEXT\`, \`WM_GETTEXT\`, \`WM_CHAR\`, \`WM_KEYDOWN\`, \`WM_KEYUP\`, \`WM_COMMAND\`, \`WM_CLOSE\`, etc.
+   - Edit & Button messages: \`EM_SETSEL\`, \`EM_REPLACESEL\`, \`EM_GETSEL\`, \`BM_CLICK\`, etc.
+   - Virtual keys: \`VK_RETURN\`, \`VK_ESCAPE\`, \`VK_SPACE\`, \`VK_BACK\`, \`VK_TAB\`, etc.
+2. **All Win32 Structs:**
+   - \`RECT\`, \`POINT\`, \`SIZE\`, \`MSG\`, \`WNDCLASSEXW\`, \`MEMORY_BASIC_INFORMATION\`, etc.
+3. **C-Style Types & Buffer Out-Parameters:**
+   - **\`WCHAR(256)\`** / **\`new WCHAR(256)\`**: Wide string buffer (UTF-16LE) with \`.text\`.
+   - **\`CHAR(256)\`** / **\`new CHAR(256)\`**: ANSI string buffer (UTF-8) with \`.text\`.
+   - **Scalar Out-Parameters:** \`DWORD()\`, \`INT()\`, \`UINT()\`, \`BOOL()\`, \`HWND()\`. Read via \`.value\` or \`+val\`.
+4. **All Win32 API Functions:**
+   - \`SendMessage\`, \`PostMessage\`, \`FindWindow\`, \`FindWindowEx\`, \`GetWindowRect\`, \`SetWindowText\`, \`GetWindowText\`, \`VirtualAlloc\`, \`VirtualProtect\`, \`VirtualFree\`, \`malloc\`, \`free\`, etc.
+
+---
+
+## 3. MCP Tool Catalog
+
+- **\`list_processes\`**: Discover running processes.
+- **\`spawn_process\`**: Launch an executable application.
+- **\`open_accessor\`**: Attach to a target process and start active session.
+- **\`close_accessor\`**: Detach and close active session.
+- **\`execute_code\`**: Run C-style Win32 code inside the attached target.
+- **\`execute_local_code\`**: Run C-style Win32 code locally in the runner.
+- **\`read_memory\`**: Read memory bytes (returns hex, ascii, u32, u64).
+- **\`write_memory\`**: Write hex bytes to target memory.
+- **\`scan_pattern\`**: AOB pattern search with \`?\` wildcards.
+- **\`allocate_memory\`**: Allocate virtual memory inside target.
+- **\`minhook_install\`**: Install 5-byte relative JMP trampoline detour hook.
+- **\`minhook_remove\`**: Remove minhook and restore original function prologue.
+- **\`list_hooks\`**: List active hooks.
+- **\`nthread_call\`**: Call function via thread context redirection without CreateRemoteThread.
+- **\`compile_c\` / \`compile_shellcode\`**: Compile C code into standalone x86_64 machine code / shellcode.
+- **\`disassemble\`**: Disassemble machine code bytes into assembly instructions.
+- **\`simulate_run\`**: Offline virtual x86_64 CPU simulation.
+- **\`list_windows\`**: Enumerate visible desktop windows and child edit controls.
+- **\`take_screenshot\`**: Capture PNG screenshot of desktop or window.
+- **\`jvm_inspect_jar\`**: Inspect JAR archive classes and packages.
+`;
+function getSkillContent() {
+  const candidates = [
+    join2(process.cwd(), ".agents", "skills", "exoproc", "SKILL.md"),
+    join2(process.cwd(), "..", "..", ".agents", "skills", "exoproc", "SKILL.md")
+  ];
+  for (const c of candidates) {
+    if (existsSync3(c)) {
+      try {
+        return readFileSync2(c, "utf8");
+      } catch {}
+    }
+  }
+  return DEFAULT_SKILL_CONTENT;
+}
+function installSkills(paths, dryRun = false) {
+  const content = getSkillContent();
+  const installed = [];
+  for (const targetPath of paths) {
+    try {
+      if (!dryRun) {
+        const dir = dirname3(targetPath);
+        if (!existsSync3(dir)) {
+          mkdirSync2(dir, { recursive: true });
+        }
+        writeFileSync2(targetPath, content, "utf8");
+      }
+      installed.push(targetPath);
+    } catch (err) {
+      console.error(`Failed to install skill to ${targetPath}:`, err);
+    }
+  }
+  return installed;
+}
+
+// packages/exoproc/src/setup/index.ts
+function createSetupContext(options) {
+  const home = homedir();
+  const platform = process.platform;
+  const env = process.env;
+  const cwd = process.cwd();
+  let command = options?.command;
+  if (!command || command.length === 0) {
+    if (options?.dev) {
+      const localDist = join3(cwd, "packages", "exoproc", "dist", "cli.js");
+      command = ["bun", localDist, "mcp"];
+    } else {
+      command = ["bun", "x", "exoproc", "mcp"];
+    }
+  }
+  return {
+    home,
+    platform,
+    env,
+    cwd,
+    command
+  };
+}
+function detectClients(ctx) {
+  const results = [];
+  for (const client of SUPPORTED_CLIENTS) {
+    const detected = client.detect(ctx);
+    const configPaths = client.getConfigPaths(ctx);
+    const primaryConfig = configPaths[0] ?? "";
+    const alreadyConfigured = isClientConfigured(client, primaryConfig, ctx.command);
+    const skillPaths = client.getSkillPaths ? client.getSkillPaths(ctx) : [];
+    results.push({
+      client,
+      detected,
+      configPath: primaryConfig,
+      alreadyConfigured,
+      skillPaths
+    });
+  }
+  return results;
+}
+async function runSetup(options = {}) {
+  const ctx = createSetupContext({
+    command: options.command,
+    dev: options.dev
+  });
+  const statuses = detectClients(ctx);
+  const targetStatuses = statuses.filter((st) => {
+    if (options.clients && options.clients.length > 0) {
+      return options.clients.includes(st.client.id);
+    }
+    return st.detected;
+  });
+  const summary = {
+    configured: [],
+    alreadyCurrent: [],
+    failed: [],
+    skillsInstalled: [],
+    dryRun: !!options.dryRun
+  };
+  for (const st of targetStatuses) {
+    if (options.skillOnly) {
+      if (st.skillPaths.length > 0) {
+        const installed = installSkills(st.skillPaths, options.dryRun);
+        summary.skillsInstalled.push(...installed);
+      }
+      continue;
+    }
+    const configPaths = st.client.getConfigPaths(ctx);
+    for (const cfgPath of configPaths) {
+      const res = updateClientConfig(st.client, cfgPath, ctx.command, options.dryRun);
+      if (res.status === "configured") {
+        summary.configured.push(`${st.client.displayName} (${cfgPath})`);
+      } else if (res.status === "already_current") {
+        summary.alreadyCurrent.push(`${st.client.displayName} (${cfgPath})`);
+      } else if (res.status === "failed") {
+        summary.failed.push({
+          client: st.client.displayName,
+          error: res.error || "Unknown error"
+        });
+      }
+    }
+    if (st.skillPaths.length > 0) {
+      const installed = installSkills(st.skillPaths, options.dryRun);
+      summary.skillsInstalled.push(...installed);
+    }
+  }
+  return summary;
+}
+export {
+  DEFAULT_SKILL_CONTENT,
+  SUPPORTED_CLIENTS,
+  createSetupContext,
+  detectClients,
+  getSkillContent,
+  installSkills,
+  isClientConfigured,
+  runSetup,
+  updateClientConfig
+};

package/dist/setup/index.js.map

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

package/dist/setup/skill-installer.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_SKILL_CONTENT = "---\nname: exoproc\ndescription: >-\n  Native Windows x64 reverse engineering, thread hijacking (nthread), function redirection (minhook 5-byte detour), memory inspection, live Win32 code execution, remote desktop inspection, and JVM analysis via the Exoproc MCP Server.\n---\n\n# Exoproc MCP Server Guide\n\nExoproc is a dedicated **Model Context Protocol (MCP)** server for native Windows x64 reverse engineering, thread hijacking (`nthread`), function redirection (`minhook`), live process instrumentation, and remote desktop inspection.\n\n> **Important Rule for AI Agents:** When asked to automate, inspect, or instrument a live process (e.g., typing into Notepad, reading/writing memory, calling Win32 APIs, or hooking functions), **use the Exoproc MCP tools directly**. Do **not** search the workspace repository source code unless explicitly asked to modify Exoproc itself.\n\n---\n\n## 1. Single Active Accessor Session Lifecycle (Mandatory Workflow)\n\nThe MCP server maintains **at most ONE active accessor session** at any time.\n\n### The Required 3-Step Lifecycle:\n```\n1. list_processes / list_windows  --> Find target PID\n2. open_accessor({ pid })          --> Opens the single active session (returns sessionId)\n3. execute_code / read_memory / ...--> Operates on the active session\n4. close_accessor({})              --> Restores target thread execution and closes session\n```\n\n- **`open_accessor({ pid: number })` is mandatory:** `execute_code` and memory tools will NOT automatically open an accessor for you. You must explicitly open the session first.\n- **Single active session:** Only 1 process can be attached at a time. If you attempt to call `open_accessor` while a session is already active, it will return an error instructing you to call `close_accessor` first.\n- **Convenience in subsequent calls:** Once `open_accessor` is called, tools like `execute_code({ code: ... })`, `read_memory(...)`, `write_memory(...)`, etc. automatically operate on the currently active session \u2014 you do not even need to pass `session` on every call.\n- **Clean exit:** Always call `close_accessor({})` when you are done with your task.\n\n---\n\n## 2. C-Style Win32 Code Execution (`execute_code` & `execute_local_code`)\n\nInside `execute_code`, write real Win32 C code as if `<windows.h>` were already included at the top:\n\n### Pre-Included Globally in Scope:\n1. **All Win32 `#define` Constants:**\n   - Window messages: `WM_SETTEXT`, `WM_GETTEXT`, `WM_CHAR`, `WM_KEYDOWN`, `WM_KEYUP`, `WM_COMMAND`, `WM_CLOSE`, etc.\n   - Edit & Button messages: `EM_SETSEL`, `EM_REPLACESEL`, `EM_GETSEL`, `BM_CLICK`, etc.\n   - Virtual keys: `VK_RETURN`, `VK_ESCAPE`, `VK_SPACE`, `VK_BACK`, `VK_TAB`, etc.\n2. **All Win32 Structs:**\n   - `RECT`, `POINT`, `SIZE`, `MSG`, `WNDCLASSEXW`, `MEMORY_BASIC_INFORMATION`, etc.\n3. **C-Style Types & Buffer Out-Parameters:**\n   - **`WCHAR(256)`** / **`new WCHAR(256)`**: Wide string buffer (UTF-16LE) with `.text`.\n   - **`CHAR(256)`** / **`new CHAR(256)`**: ANSI string buffer (UTF-8) with `.text`.\n   - **Scalar Out-Parameters:** `DWORD()`, `INT()`, `UINT()`, `BOOL()`, `HWND()`. Read via `.value` or `+val`.\n4. **All Win32 API Functions:**\n   - `SendMessage`, `PostMessage`, `FindWindow`, `FindWindowEx`, `GetWindowRect`, `SetWindowText`, `GetWindowText`, `VirtualAlloc`, `VirtualProtect`, `VirtualFree`, `malloc`, `free`, etc.\n\n---\n\n## 3. MCP Tool Catalog\n\n- **`list_processes`**: Discover running processes.\n- **`spawn_process`**: Launch an executable application.\n- **`open_accessor`**: Attach to a target process and start active session.\n- **`close_accessor`**: Detach and close active session.\n- **`execute_code`**: Run C-style Win32 code inside the attached target.\n- **`execute_local_code`**: Run C-style Win32 code locally in the runner.\n- **`read_memory`**: Read memory bytes (returns hex, ascii, u32, u64).\n- **`write_memory`**: Write hex bytes to target memory.\n- **`scan_pattern`**: AOB pattern search with `?` wildcards.\n- **`allocate_memory`**: Allocate virtual memory inside target.\n- **`minhook_install`**: Install 5-byte relative JMP trampoline detour hook.\n- **`minhook_remove`**: Remove minhook and restore original function prologue.\n- **`list_hooks`**: List active hooks.\n- **`nthread_call`**: Call function via thread context redirection without CreateRemoteThread.\n- **`compile_c` / `compile_shellcode`**: Compile C code into standalone x86_64 machine code / shellcode.\n- **`disassemble`**: Disassemble machine code bytes into assembly instructions.\n- **`simulate_run`**: Offline virtual x86_64 CPU simulation.\n- **`list_windows`**: Enumerate visible desktop windows and child edit controls.\n- **`take_screenshot`**: Capture PNG screenshot of desktop or window.\n- **`jvm_inspect_jar`**: Inspect JAR archive classes and packages.\n";
+export declare function getSkillContent(): string;
+export declare function installSkills(paths: string[], dryRun?: boolean): string[];
+//# sourceMappingURL=skill-installer.d.ts.map

package/dist/setup/skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../../src/setup/skill-installer.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,8uJA2EjC,CAAC;AAEF,wBAAgB,eAAe,IAAI,MAAM,CAcxC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,UAAQ,GAAG,MAAM,EAAE,CAkBvE"}

package/dist/setup/skill-installer.js

@@ -0,0 +1,115 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export const DEFAULT_SKILL_CONTENT = `---
+name: exoproc
+description: >-
+  Native Windows x64 reverse engineering, thread hijacking (nthread), function redirection (minhook 5-byte detour), memory inspection, live Win32 code execution, remote desktop inspection, and JVM analysis via the Exoproc MCP Server.
+---
+
+# Exoproc MCP Server Guide
+
+Exoproc is a dedicated **Model Context Protocol (MCP)** server for native Windows x64 reverse engineering, thread hijacking (\`nthread\`), function redirection (\`minhook\`), live process instrumentation, and remote desktop inspection.
+
+> **Important Rule for AI Agents:** When asked to automate, inspect, or instrument a live process (e.g., typing into Notepad, reading/writing memory, calling Win32 APIs, or hooking functions), **use the Exoproc MCP tools directly**. Do **not** search the workspace repository source code unless explicitly asked to modify Exoproc itself.
+
+---
+
+## 1. Single Active Accessor Session Lifecycle (Mandatory Workflow)
+
+The MCP server maintains **at most ONE active accessor session** at any time.
+
+### The Required 3-Step Lifecycle:
+\`\`\`
+1. list_processes / list_windows  --> Find target PID
+2. open_accessor({ pid })          --> Opens the single active session (returns sessionId)
+3. execute_code / read_memory / ...--> Operates on the active session
+4. close_accessor({})              --> Restores target thread execution and closes session
+\`\`\`
+
+- **\`open_accessor({ pid: number })\` is mandatory:** \`execute_code\` and memory tools will NOT automatically open an accessor for you. You must explicitly open the session first.
+- **Single active session:** Only 1 process can be attached at a time. If you attempt to call \`open_accessor\` while a session is already active, it will return an error instructing you to call \`close_accessor\` first.
+- **Convenience in subsequent calls:** Once \`open_accessor\` is called, tools like \`execute_code({ code: ... })\`, \`read_memory(...)\`, \`write_memory(...)\`, etc. automatically operate on the currently active session — you do not even need to pass \`session\` on every call.
+- **Clean exit:** Always call \`close_accessor({})\` when you are done with your task.
+
+---
+
+## 2. C-Style Win32 Code Execution (\`execute_code\` & \`execute_local_code\`)
+
+Inside \`execute_code\`, write real Win32 C code as if \`<windows.h>\` were already included at the top:
+
+### Pre-Included Globally in Scope:
+1. **All Win32 \`#define\` Constants:**
+   - Window messages: \`WM_SETTEXT\`, \`WM_GETTEXT\`, \`WM_CHAR\`, \`WM_KEYDOWN\`, \`WM_KEYUP\`, \`WM_COMMAND\`, \`WM_CLOSE\`, etc.
+   - Edit & Button messages: \`EM_SETSEL\`, \`EM_REPLACESEL\`, \`EM_GETSEL\`, \`BM_CLICK\`, etc.
+   - Virtual keys: \`VK_RETURN\`, \`VK_ESCAPE\`, \`VK_SPACE\`, \`VK_BACK\`, \`VK_TAB\`, etc.
+2. **All Win32 Structs:**
+   - \`RECT\`, \`POINT\`, \`SIZE\`, \`MSG\`, \`WNDCLASSEXW\`, \`MEMORY_BASIC_INFORMATION\`, etc.
+3. **C-Style Types & Buffer Out-Parameters:**
+   - **\`WCHAR(256)\`** / **\`new WCHAR(256)\`**: Wide string buffer (UTF-16LE) with \`.text\`.
+   - **\`CHAR(256)\`** / **\`new CHAR(256)\`**: ANSI string buffer (UTF-8) with \`.text\`.
+   - **Scalar Out-Parameters:** \`DWORD()\`, \`INT()\`, \`UINT()\`, \`BOOL()\`, \`HWND()\`. Read via \`.value\` or \`+val\`.
+4. **All Win32 API Functions:**
+   - \`SendMessage\`, \`PostMessage\`, \`FindWindow\`, \`FindWindowEx\`, \`GetWindowRect\`, \`SetWindowText\`, \`GetWindowText\`, \`VirtualAlloc\`, \`VirtualProtect\`, \`VirtualFree\`, \`malloc\`, \`free\`, etc.
+
+---
+
+## 3. MCP Tool Catalog
+
+- **\`list_processes\`**: Discover running processes.
+- **\`spawn_process\`**: Launch an executable application.
+- **\`open_accessor\`**: Attach to a target process and start active session.
+- **\`close_accessor\`**: Detach and close active session.
+- **\`execute_code\`**: Run C-style Win32 code inside the attached target.
+- **\`execute_local_code\`**: Run C-style Win32 code locally in the runner.
+- **\`read_memory\`**: Read memory bytes (returns hex, ascii, u32, u64).
+- **\`write_memory\`**: Write hex bytes to target memory.
+- **\`scan_pattern\`**: AOB pattern search with \`?\` wildcards.
+- **\`allocate_memory\`**: Allocate virtual memory inside target.
+- **\`minhook_install\`**: Install 5-byte relative JMP trampoline detour hook.
+- **\`minhook_remove\`**: Remove minhook and restore original function prologue.
+- **\`list_hooks\`**: List active hooks.
+- **\`nthread_call\`**: Call function via thread context redirection without CreateRemoteThread.
+- **\`compile_c\` / \`compile_shellcode\`**: Compile C code into standalone x86_64 machine code / shellcode.
+- **\`disassemble\`**: Disassemble machine code bytes into assembly instructions.
+- **\`simulate_run\`**: Offline virtual x86_64 CPU simulation.
+- **\`list_windows\`**: Enumerate visible desktop windows and child edit controls.
+- **\`take_screenshot\`**: Capture PNG screenshot of desktop or window.
+- **\`jvm_inspect_jar\`**: Inspect JAR archive classes and packages.
+`;
+export function getSkillContent() {
+    // Try loading from repo skill if present
+    const candidates = [
+        join(process.cwd(), '.agents', 'skills', 'exoproc', 'SKILL.md'),
+        join(process.cwd(), '..', '..', '.agents', 'skills', 'exoproc', 'SKILL.md'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c)) {
+            try {
+                return readFileSync(c, 'utf8');
+            }
+            catch { }
+        }
+    }
+    return DEFAULT_SKILL_CONTENT;
+}
+export function installSkills(paths, dryRun = false) {
+    const content = getSkillContent();
+    const installed = [];
+    for (const targetPath of paths) {
+        try {
+            if (!dryRun) {
+                const dir = dirname(targetPath);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+                writeFileSync(targetPath, content, 'utf8');
+            }
+            installed.push(targetPath);
+        }
+        catch (err) {
+            console.error(`Failed to install skill to ${targetPath}:`, err);
+        }
+    }
+    return installed;
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/setup/skill-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.js","sourceRoot":"","sources":["../../src/setup/skill-installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EpC,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,yCAAyC;IACzC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;KAC5E,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,MAAM,GAAG,KAAK;IAC3D,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;gBAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtC,CAAC;gBACD,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7C,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,GAAG,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/setup/types.d.ts

@@ -0,0 +1,41 @@
+export interface SetupContext {
+    home: string;
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    command: string[];
+}
+export interface ClientDefinition {
+    id: string;
+    displayName: string;
+    format: 'json' | 'zed';
+    getConfigPaths: (ctx: SetupContext) => string[];
+    getSkillPaths?: (ctx: SetupContext) => string[];
+    detect: (ctx: SetupContext) => boolean;
+}
+export interface ClientConfigStatus {
+    client: ClientDefinition;
+    detected: boolean;
+    configPath: string;
+    alreadyConfigured: boolean;
+    skillPaths: string[];
+}
+export interface SetupOptions {
+    yes?: boolean;
+    clients?: string[];
+    dryRun?: boolean;
+    command?: string[];
+    skillOnly?: boolean;
+    dev?: boolean;
+}
+export interface SetupSummary {
+    configured: string[];
+    alreadyCurrent: string[];
+    failed: Array<{
+        client: string;
+        error: string;
+    }>;
+    skillsInstalled: string[];
+    dryRun: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/setup/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,cAAc,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,MAAM,EAAE,CAAC;IAChD,MAAM,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/setup/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/setup/types.ts"],"names":[],"mappings":""}